Compartilhar via


Office.Control interface

Representa um controlo ou comando individual e o estado que deveria ter.

Comentários

Para obter exemplos de código que mostram como utilizar um Control objeto e as respetivas propriedades, veja Alterar a disponibilidade dos comandos de suplementos e Criar separadores contextuais personalizados.

Conjunto de requisitos: RibbonAPI 1.1

Exemplos

// 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);
}

Propriedades

enabled

Indica se o controlo deve estar ativado ou desativado. O padrão é verdadeiro.

id

Identificador do controlo, conforme especificado no manifesto.

Detalhes da propriedade

enabled

Indica se o controlo deve estar ativado ou desativado. O padrão é verdadeiro.

enabled?: boolean;

Valor da propriedade

boolean

id

Identificador do controlo, conforme especificado no manifesto.

id: string;

Valor da propriedade

string