Office.Control interface

注解

有关演示如何使用 Control 对象及其属性的代码示例，请参阅 更改外接程序命令的可用性 和 创建自定义上下文选项卡。

要求集： RibbonAPI 1.1

示例

// This snippet enables a control (a button) in a custom ribbon tab.
// Note that "MyButton", "OfficeAddinTab1", and "CustomGroup111" are defined in the manifest.
const enableButton = async () => {
    const button: Control = { id: "MyButton", enabled: true };
    const parentGroup: Group = { id: "CustomGroup111", controls: [button] };
    const parentTab: Tab = { id: "OfficeAddinTab1", groups: [parentGroup] };
    const ribbonUpdater: RibbonUpdaterData = { tabs: [parentTab] };
    Office.ribbon.requestUpdate(ribbonUpdater);
}

属性

enabled

enabled?: boolean;

id

id: string;