Integrar botões internos do Office em grupos de controle e guias personalizados

Você pode inserir botões internos do Office em seus grupos de controle personalizados na faixa de opções do Office usando marcação no manifesto do suplemento. (Não é possível inserir seus comandos de suplemento personalizados em um grupo interno do Office.) Você também pode inserir grupos de controle internos inteiros do Office em suas guias personalizadas da faixa de opções.

Observação

Este artigo presume que você conhece o artigo Conceitos básicos para comandos de suplemento. Por favor, revise-o se você não tiver feito isso recentemente.

Importante

O recurso de suplemento descrito neste artigo só está disponível no PowerPoint na Web, no Windows e no Mac.

Abra a guia do tipo de manifesto que seu suplemento usa para obter os detalhes da marcação do manifesto.

Inserir um grupo de controle interno em uma guia personalizada

Para inserir um grupo de controle interno do Office em uma guia personalizada, adicione um objeto de grupo com uma "builtInGroupId" propriedade, em vez de uma "id" propriedade , "groups" à matriz do objeto de guia personalizado. Defina como a ID do grupo interno. Consulte Localizar as IDs de controles e grupos de controle. O objeto de grupo interno não deve ter outras propriedades.

O exemplo a seguir adiciona o grupo de controle Parágrafo do Office a uma guia personalizada.

"extensions": [
    ...
    {
        ...
        "ribbons": [
            ...
            {
                ...
                "tabs": [
                    {
                        "id": "MyTab",
                        ...
                        "groups": [
                            ... // Optionally, other groups in the tab.
                            {
                                "builtInGroupId": "Paragraph"
                            },
                            ... // Optionally, other groups in the tab.
                        ]
                    }
                ]
            }
        ]
    }
]

Inserir um controle interno em um grupo personalizado

Para inserir um controle interno do Office em um grupo personalizado, adicione um objeto de controle com uma "builtInControlId" propriedade, em vez de uma "id" propriedade , "controls" à matriz do objeto de grupo personalizado. Defina como a ID do controle interno. Consulte Localizar as IDs de controles e grupos de controle. O objeto de controle interno não deve ter outras propriedades.

O exemplo a seguir adiciona o controle sobrescrito do Office a um grupo personalizado.

"extensions": [
    ...
    {
        ...
        "ribbons": [
            ...
            {
                ...
                "tabs": [
                    {
                        ...
                        "groups": [
                            {
                                "id": "MyGroup",
                                ...
                                "controls": [
                                    ... // Optionally, other controls in the group.
                                    {
                                        "builtInControlId": "Superscript"
                                    },
                                    ... // Optionally, other controls in the group.
                                ]
                            }
                        ]
                    }
                ]
            }
        ]
    }
]

Observação

Os usuários podem personalizar a faixa de opções no aplicativo do Office. Quaisquer personalizações do usuário substituirão suas configurações de manifesto. Por exemplo, um usuário pode remover um botão de qualquer grupo e remover qualquer grupo de uma guia.

Localizar as IDs de controles e grupos de controle

As IDs para controles e grupos de controle com suporte estão em arquivos nas IDs de Controle do Office do repositório. Siga as instruções no arquivo Leiame desse repositório.

Comportamento em plataformas sem suporte

Se o suplemento estiver instalado em uma plataforma que não oferece suporte ao AddinCommands 1.3 definido de requisitos, a marcação descrita neste artigo será ignorada e os controles/grupos internos do Office não aparecerão em seus grupos/guias personalizados. Para impedir que o suplemento seja instalado em plataformas que não dão suporte à marcação, você deve especificar AddinCommands 1.3 no manifesto como um requisito para a instalação. Para obter instruções, consulte Especificar quais versões e plataformas do Office podem hospedar seu suplemento. Como alternativa, projete seu suplemento para ter uma experiência quando o AddinCommands 1.3 não tiver suporte, conforme descrito em Design para experiências alternativas. Por exemplo, se o suplemento contiver instruções que pressupõem que os botões internos estão em seus grupos personalizados, você pode criar uma versão que pressupõe que os botões internos estejam apenas em seus lugares habituais.

  • Last updated on