Integrar botões incorporados do Office em separadores e grupos de controlo personalizados
Pode inserir botões incorporados do Office nos seus grupos de controlo personalizados no friso do Office através da marcação no manifesto do suplemento. (Não pode inserir os seus comandos de suplemento personalizados num grupo incorporado do Office.) Também pode inserir grupos de controlo do Office incorporados inteiros nos seus separadores personalizados do friso.
Observação
Este artigo pressupõe que está familiarizado com o artigo Conceitos básicos para comandos de suplementos. Reveja-o se ainda não o fez recentemente.
Importante
A funcionalidade de suplemento descrita neste artigo só está disponível no PowerPoint na Web, no Windows e no Mac.
Abra o separador para o tipo de manifesto que o suplemento utiliza para obter os detalhes da marcação do manifesto.
Observação
O manifesto unificado do Microsoft 365 pode ser utilizado nos suplementos de produção do Outlook. Está disponível apenas como uma pré-visualização para suplementos do Excel, PowerPoint e Word.
Inserir um grupo de controlo incorporado num separador personalizado
Para inserir um grupo de controlo incorporado do Office num separador personalizado, adicione um objeto de grupo com uma propriedade "builtInGroupId" em vez de uma propriedade "id" à matriz "groups" do seu objeto de separador personalizado. Defina como o ID do grupo incorporado. Veja Localizar os IDs dos controlos e grupos de controlo. O objeto de grupo incorporado não deve ter outras propriedades.
O exemplo seguinte adiciona o grupo de controlo Parágrafo do Office a um separador personalizado.
"extensions": [
...
{
...
"ribbons": [
...
{
...
"tabs": [
{
"id": "MyTab",
...
"groups": [
... // Optionally, other groups in the tab
{
"builtInGroupId": "Paragraph"
},
... // Optionally, other groups in the tab
]
}
]
}
]
}
]
Inserir um controlo incorporado num grupo personalizado
Para inserir um controlo incorporado do Office num grupo personalizado, adicione um objeto de controlo com uma propriedade "builtInControlId" em vez de uma propriedade "id" à matriz "controls" do objeto de grupo personalizado. Defina como o ID do controlo incorporado. Veja Localizar os IDs dos controlos e grupos de controlo. O objeto de controlo incorporado não deve ter outras propriedades.
O exemplo seguinte adiciona o controlo Superior à Linha 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 utilizadores podem personalizar o friso na aplicação do Office. Quaisquer personalizações de utilizador irão substituir as suas definições de manifesto. Por exemplo, um utilizador pode remover um botão de qualquer grupo e remover qualquer grupo de um separador.
Localizar os IDs de controlos e grupos de controlo
Os IDs dos controlos e grupos de controlo suportados estão em ficheiros nos IDs de Controlo do Office do repositório. Siga as instruções no ficheiro ReadMe desse repositório.
Comportamento em plataformas não suportadas
Se o seu suplemento estiver instalado numa plataforma que não suporta o conjunto de requisitos AddinCommands 1.3, a marcação descrita neste artigo é ignorada e os controlos/grupos incorporados do Office não serão apresentados nos seus grupos/separadores personalizados. Para impedir que o suplemento seja instalado em plataformas que não suportam a marcação, tem de especificar AddinCommands 1.3 no manifesto como um requisito para a instalação. Para obter instruções, consulte Especificar que versões e plataformas do Office podem alojar o seu suplemento. Em alternativa, crie o seu suplemento para ter uma experiência quando o AddinCommands 1.3 não é suportado, conforme descrito em Estrutura para experiências alternativas. Por exemplo, se o seu suplemento contiver instruções que partem do princípio de que os botões incorporados estão nos seus grupos personalizados, pode estruturar uma versão que pressupõe que os botões incorporados estão apenas nos locais habituais.