金山文档开放平台

主题

回到顶部
本页内容

新增定制元素

CommandBars(CommandBarId).Controls.Add()

通过 Controls.Add() 方法，可以在对应的 Tab 中添加【自定义按钮】以及【自定义下拉组件】。

添加前

定制位置

添加后

定制位置

语法

表达式.CommandBars(CommandBarId).Controls.Add(Type)

表达式：文档类型应用对象

参数

属性数据类型默认值必填说明
Type
Enum
是
新增的定制元素类型，为 1 是可控按钮，为 10 是可控的下拉框，详细可见： Enum.MsoControlType

示例 

//@file=base.docx
async function example() {
  await instance.ready();

  const app = instance.Application;

  // 定制元素对象【开始 Tab】
  const controls = await app.CommandBars('StartTab').Controls;
  
  // 新增按钮型定制元素
  const controlButton = await controls.Add(1);
  controlButton.Caption = '按钮';

  // 新增下拉框型定制元素
  const controlPopup = await controls.Add(10);
  controlPopup.Caption = '下拉框';
}