Office.Group interface

Pacote:

office

Representa um grupo de controlos num separador do friso.

Conjunto de requisitos: RibbonApi 1.1

Comentários

Exemplos

/**
 * Shows or hides a contextual tab.
 */
async function setContextualTabVisibility(visible: boolean) {
    // Define a tab group of controls.
    const group: Office.Group = {
        id: "TableToolsGroup",
        controls: [
            // The controls of the group...
        ],
    };
    
    // Update the ribbon to show or hide a tab with the specified group of controls.
    await Office.ribbon.requestUpdate({
        tabs: [
            {
                id: "contextTab1",
                visible: visible,
                groups: [group],
            },
        ],
    });
}

Propriedades

controls	Especifica um ou mais dos controlos no grupo, como itens de menu, botões, etc.
id	Identificador do grupo conforme especificado no manifesto.

Detalhes da propriedade

controls

Especifica um ou mais dos controlos no grupo, como itens de menu, botões, etc.

controls?: Control[];

Valor da propriedade

Office.Control[]

Comentários

Quando o Group objeto faz parte de um objeto Office.RibbonUpdaterData transmitido ao requestUpdate método do Office.Ribbon, as controls propriedades dos vários objetos Office.Group especificam quais os controlos que têm os respetivos controlos ativados status alterados; a controls propriedade do Group objeto principal Tab do objeto é ignorada.

id

Identificador do grupo conforme especificado no manifesto.

id: string;

Valor da propriedade

string