Elemento Host

  • Artículo

Especifica un tipo individual de aplicación de Office en el que se debe activar el complemento.

Importante

La <sintaxis del elemento Host> varía en función de si el elemento se define dentro del manifiesto básico o dentro del nodo VersionOverrides . Sin embargo, las funciones son las mismas.

Manifiesto básico

Cuando se define en el manifiesto básico (bajo OfficeApp), el tipo de host está determinado en el atributo Name.

Atributos

Atributo Tipo Obligatorio Descripción
Name string Sí Nombre del tipo de aplicación cliente de Office.

Nombre

Especifica el tipo de host al que se dirige este complemento. El valor debe ser uno de los siguientes:

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

Ejemplo

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

Nodo VersionOverrides

Cuando se define en VersionOverrides, el tipo de host está determinado en el atributo xsi:type.

Este elemento invalida el <elemento Hosts> en el manifiesto básico.

Tipo de complemento: Panel de tareas, Correo

Solo es válido en estos esquemas VersionOverrides:

  • Panel de tareas 1.0
  • Correo 1.0
  • Correo 1.1

Para obtener más información, vea Invalidaciones de versión en el manifiesto de solo complemento.

Atributos

Atributo Obligatorio Descripción
xsi:type Sí Especifica la aplicación de Office en la que se aplica esta configuración.

Elementos secundarios

Elemento Obligatorio Descripción
DesktopFormFactor Sí Define la configuración del factor de forma de escritorio.
MobileFormFactor No Define la configuración del factor de forma móvil. Nota: Este elemento solo se admite en Outlook en Android e iOS.
AllFormFactors No Define la configuración de todos los factores de forma. Solo lo usan las funciones personalizadas en Excel.
Tiempos de ejecución No Especifica los tiempos de ejecución del complemento.

xsi:type

Controla qué aplicación de Office (Word, Excel, PowerPoint, Outlook, OneNote) donde se aplica la configuración contenida. El valor debe ser uno de los siguientes:

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

Ejemplo de host

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