Élément Host

  • Article

Spécifie un type d’application Office individuel dans lequel le complément doit s’activer.

Importante

La <syntaxe de l’élément Host> varie selon que l’élément est défini dans le manifeste de base ou dans le nœud VersionOverrides . Toutefois, la fonctionnalité est identique.

Manifeste de base

Lorsqu’il est défini dans le manifeste base (sous OfficeApp), le type d’hôte est déterminé par l’attribut Name.

Attributs

Attribut Type Requis Description
Nom string Oui Nom du type d’application cliente Office.

Nom

Spécifie le type d’hôte ciblé par ce complément. La valeur doit être l’une des suivantes :

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

Exemple

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

Nœud VersionOverrides

Lorsqu’il est défini dans VersionOverrides, le type d’hôte est déterminé par l’attribut xsi:type.

Cet élément remplace l’élément <Hosts> dans le manifeste de base.

Type de complément : Volet Office, Courrier

Valide uniquement dans les schémas VersionOverrides suivants :

  • Volet De tâches 1.0
  • Mail 1.0
  • Courrier 1.1

Pour plus d’informations, consultez Remplacements de version dans le manifeste.

Attributs

Attribut Obligatoire Description
xsi:type Oui Spécifie l’application Office dans laquelle ces paramètres s’appliquent.

Éléments enfants

Élément Obligatoire Description
DesktopFormFactor Oui Définit les paramètres pour le facteur de forme pour bureau.
MobileFormFactor Non Définit les paramètres pour le facteur de forme pour environnement mobile. Note: Cet élément est pris en charge uniquement dans Outlook sur iOS et Android.
AllFormFactors Non Définit les paramètres de tous les facteurs de forme. Utilisé uniquement par des fonctions personnalisées dans Excel.
Runtimes Non Spécifie les runtimes de votre complément.

xsi:type

Contrôle l’application Office (Word, Excel, PowerPoint, Outlook, OneNote) dans laquelle les paramètres contenus s’appliquent. La valeur doit être l’une des suivantes :

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

Exemple d’hôte

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