Skip to content

工具栏相关属性

ToolBars

说明:
布尔型;可读写;是否显示工具栏。

语法:

javascript
// 设置
Obj.ToolBars = true;  // 或 false

// 读取
var showToolbars = Obj.ToolBars;

使用示例:

javascript
// 显示工具栏
Obj.ToolBars = true;

// 隐藏工具栏
Obj.ToolBars = false;

// 检查工具栏是否显示
if (Obj.ToolBars) {
    console.log("工具栏已显示");
} else {
    console.log("工具栏已隐藏");
}

IsResetToolbarsOnOpen

说明:
布尔型;可读写;读取/设置是否在打开文档之后重置工具栏为常用模式。

语法:

javascript
// 设置
Obj.IsResetToolbarsOnOpen = true;  // 或 false

// 读取
var resetToolbars = Obj.IsResetToolbarsOnOpen;

功能说明:

  • true:打开文档后自动重置工具栏为常用模式
  • false:保持当前工具栏状态不变

使用示例:

javascript
// 启用工具栏重置功能
Obj.IsResetToolbarsOnOpen = true;

// 禁用工具栏重置功能
Obj.IsResetToolbarsOnOpen = false;

// 检查重置设置
if (Obj.IsResetToolbarsOnOpen) {
    console.log("将在打开文档后重置工具栏");
}

CustomToolBar

说明:
布尔型;可读写;显示/隐藏自定义工具栏。

语法:

javascript
// 设置
Obj.CustomToolBar = true;  // 或 false

// 读取
var showCustomToolbar = Obj.CustomToolBar;

使用示例:

javascript
// 显示自定义工具栏
Obj.CustomToolBar = true;

// 隐藏自定义工具栏
Obj.CustomToolBar = false;

// 检查自定义工具栏状态
if (Obj.CustomToolBar) {
    console.log("自定义工具栏已显示");
}

综合使用示例

javascript
// 工具栏配置函数
function configureToolbars() {
    // 显示标准工具栏
    Obj.ToolBars = true;
    
    // 显示自定义工具栏
    Obj.CustomToolBar = true;
    
    // 设置打开文档后重置工具栏
    Obj.IsResetToolbarsOnOpen = true;
    
    console.log("工具栏配置完成");
}

// 隐藏所有工具栏
function hideAllToolbars() {
    Obj.ToolBars = false;
    Obj.CustomToolBar = false;
    console.log("所有工具栏已隐藏");
}

// 显示所有工具栏
function showAllToolbars() {
    Obj.ToolBars = true;
    Obj.CustomToolBar = true;
    console.log("所有工具栏已显示");
}

// 获取工具栏状态
function getToolbarStatus() {
    return {
        toolbars: Obj.ToolBars,
        customToolbar: Obj.CustomToolBar,
        resetOnOpen: Obj.IsResetToolbarsOnOpen
    };
}

属性关系说明

属性功能默认值影响范围
ToolBars控制标准工具栏显示根据系统设置影响Office标准工具栏
CustomToolBar控制自定义工具栏显示根据系统设置影响自定义工具栏
IsResetToolbarsOnOpen打开文档时重置工具栏根据系统设置影响工具栏重置行为

注意事项

  1. 工具栏显示优先级:如果同时设置了多个工具栏属性,它们会同时生效
  2. 重置行为IsResetToolbarsOnOpen 只在打开新文档时生效
  3. 自定义工具栏CustomToolBar 需要配合相应的自定义工具栏配置使用
  4. 性能考虑:频繁切换工具栏显示状态可能影响用户体验