Suplementos de conteúdo do Office

Suplementos de conteúdo são superfícies que podem ser incorporadas diretamente em documentos do Excel ou PowerPoint. Os suplementos de conteúdo concedem aos usuários acesso a controles de interface que executam códigos para modificar documentos ou exibir dados de uma fonte de dados. Use suplementos de conteúdo quando quiser inserir a funcionalidade diretamente no documento.

Figura 1. Layout típico para suplementos de conteúdo

Práticas recomendadas

• Inclua alguns elementos de navegação ou comando, como CommandBar ou Pivot, na parte superior do suplemento.
• Inclua um elemento da marca, como BrandBar, na parte inferior do suplemento (aplica-se apenas a suplementos do Excel e do PowerPoint).

Variantes

Os tamanhos de suplemento de conteúdo para Excel e PowerPoint na área de trabalho do Office e em um navegador da Web são especificados pelo usuário.

Menu de personalidade

Menus de personalidade podem obstruir elementos de navegação e comando localizados perto da parte superior direita do suplemento. Veja a seguir as dimensões atuais do menu personalidade no Windows e Mac.

No Windows, o menu de personalidade mede 12 x 32 pixels, conforme mostrado.

Figura 2. Menu personalidade no Windows

No Mac, o menu de personalidade mede 26 x 26 pixels, mas flutua 8 pixels a partir da direita e 6 pixels a partir do topo, o que aumenta o espaço ocupado para 34 x 32 pixels, como mostrado.

Figura 3. Menu personalidade no Mac

Implementação

Há pequenas diferenças nos manifestos entre suplementos de conteúdo e suplementos que usam painéis de tarefa.

• Para o < elemento OfficeApp>, defina o xsi:type atributo como "ContentApp".
• < No elemento DefaultSettings, adicione os elementos >RequestedHeight> e RequestedWidth.<><

Para ver um exemplo que implementa um suplemento de conteúdo, confira Suplemento de conteúdo do Excel Humongous Insurance no GitHub.

Considerações sobre o suporte

• Verifique se seu Suplemento do Office funcionará em um aplicativo ou plataforma específico do Office.
• Alguns suplementos de conteúdo podem obrigar o usuário a "confiar" nele para ler e gravar no Excel ou PowerPoint. Você pode declarar no manifesto do suplemento quais níveis de permissão deseja que o usuário tenha.

Confira também

• Disponibilidade de aplicativos e plataformas do cliente Office para Suplementos do Office
• Núcleo da Malha em Suplementos do Office
• Padrões de design da experiência do usuário para suplementos do Office
• Solicitar permissões para uso da API em suplementos