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

Layout típico para suplementos de conteúdo em um aplicativo do Office.

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 de personalidade no Windows

Menu de personalidade de 12 x 32 pixels na área de trabalho do 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

Menu de personalidade de 34x32 pixels na área de trabalho do Mac.

Implementação

Há pequenas diferenças nos manifestos entre suplementos de conteúdo e suplementos que usam painéis de tarefas. Abra a guia do tipo de manifesto que você está usando.

Configure o manifesto com as etapas a seguir.

  1. Adicione uma "contentRuntimes" matriz filho ao objeto de extensão na "extensions" matriz.
  2. Remova a "runtimes" propriedade se ela estiver presente. A "runtimes" matriz é para o painel de tarefas ou suplementos de email. Eles não podem ser combinados com um suplemento de conteúdo.
  3. Adicione um objeto de tempo de execução de conteúdo anônimo na "contentRuntimes" matriz.
  4. Defina a "id" propriedade do objeto com um nome descritivo.
  5. Defina o "code.page" objeto como a URL completa do conteúdo personalizado que você deseja incorporar ao documento.
  6. Opcionalmente, defina as "requestedWidth" propriedades and "requestedHeight" como um tamanho entre 32 e 1000 pixels. Se essas propriedades não forem usadas, o aplicativo do Office determinará o tamanho.
  7. Opcionalmente, defina a "disableSnapshot" propriedade como true para impedir que o Office salve uma snapshot do componente de conteúdo com o documento.

Veja a seguir um exemplo de uma "contentRuntimes" propriedade.

"contentRuntimes": [
    {
        "id": "ContentRuntime",
        "code": {
            "page": "https://localhost:3000/content.html"
        },
        "requestedWidth": 100,
        "requestedHeight": 100,
        "disableSnapshot": true,
    }
]

Exemplos no GitHub

Há exemplos de código de suplemento de conteúdo disponíveis no repositório GitHub-Office-Add-in-samples. Você pode usar qualquer uma delas como base para seu próprio projeto de suplemento. Vários deles também oferecem a opção de experimentar o suplemento sem executá-lo localmente.

Considerações sobre o suporte

  • Verifique se o seu suplemento do Office funcionará em um aplicativo ou plataforma específica 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.
  • No Office na Web, a opção Mostrar como imagem salva não tem suporte. Mesmo que a opção Mostrar como imagem salva tenha sido habilitada em um cliente da área de trabalho, o suplemento de conteúdo permanecerá interativo no cliente Web.

Confira também

  • Last updated on