Elemento Host

Especifica um tipo de aplicativo individual do Office em que o suplemento deve ser ativado.

Importante

A <sintaxe do elemento Host> varia dependendo se o elemento é definido dentro do manifesto básico ou dentro do nó VersionOverrides . No entanto, a funcionalidade é a mesma.

Manifesto básico

Quando definido no manifesto básico (em OfficeApp), o tipo de host é determinado pelo atributo Name.

Atributos

Atributo Tipo Obrigatório Descrição
Nome string Sim O nome do tipo de aplicativo cliente do Office.

Nome

Especifica o tipo de Host destinado por esse suplemento. O valor deve ser uma das seguintes opções:

  • Document (Word)
  • Database (Access)
  • Mailbox (Outlook)
  • Notebook (OneNote)
  • Presentation (PowerPoint)
  • Project (Project)
  • Workbook (Excel)

Exemplo

<Hosts>
    <Host Name="Mailbox">
    </Host>
</Hosts>

Nó VersionOverrides

Quando definido em VersionOverrides, o tipo de host é determinado pelo atributo xsi:type.

Esse elemento substitui o <elemento Hosts> no manifesto básico.

Tipo de suplemento: Painel de tarefas, Email

Válido somente nestes esquemas VersionOverrides:

  • Painel de tarefas 1.0
  • Email 1.0
  • Email 1.1

Para obter mais informações, consulte Substituições de versão no manifesto.

Atributos

Atributo Obrigatório Descrição
xsi:type Sim Especifica o aplicativo do Office em que essas configurações se aplicam.

Elementos filho

Elemento Obrigatório Descrição
DesktopFormFactor Sim Define as configurações do fator forma da área de trabalho.
MobileFormFactor Não Define as configurações do fator forma móvel. Nota: Esse elemento só tem suporte no Outlook no iOS e no Android.
AllFormFactors Não Define as configurações de todos os fatores forma. Usado somente pelas funções personalizadas no Excel.
Runtimes Não Especifica os runtimes do suplemento.

xsi:type

Controla qual aplicativo do Office (Word, Excel, PowerPoint, Outlook, OneNote) em que as configurações contidas se aplicam. O valor deve ser uma das seguintes opções:

  • Document (Word)
  • MailHost (Outlook)
  • Notebook (OneNote)
  • Presentation (PowerPoint)
  • Workbook (Excel)

Exemplo de host

<Hosts>
    <Host xsi:type="MailHost">
        <!-- Host Settings -->
    </Host>
</Hosts>