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