Элемент Host

  • Статья

Определяет тип приложения Office, в котором следует активировать надстройку.

Важно!

<Синтаксис элемента Host> зависит от того, определен ли элемент в базовом манифесте или в узле VersionOverrides. Функциональность в обоих случаях одинакова.

Базовый манифест

Если ведущее приложение задается в базовом манифесте (в разделе OfficeApp), то его тип определяет атрибут Name.

Атрибуты

Атрибут Тип Обязательный Описание
Name string Да Имя типа клиентского приложения Office.

Имя

Определяет тип ведущего приложения, для которого предназначена эта надстройка. Поддерживаются такие значения:

  • Document (Word)
  • Mailbox (Outlook)
  • Notebook (OneNote)
  • Presentation (PowerPoint)
  • Project (Project)
  • Workbook (Excel)
  • Database (Доступ (устаревший))

Пример

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

Узел VersionOverrides

Если основной элемент задается в узле VersionOverrides, его тип определяет атрибут xsi:type.

Этот элемент переопределяет <элемент Hosts> в базовом манифесте.

Тип надстройки: Область задач, почта

Допустимо только в следующих схемах VersionOverrides:

  • Область задач 1.0
  • Почта 1.0
  • Почта 1.1

Дополнительные сведения см. в разделе Переопределения версий в манифесте только надстройки.

Атрибуты

Атрибут Обязательный Описание
xsi:type Да Указывает приложение Office, к которому применяются эти параметры.

Дочерние элементы

Элемент Обязательный Описание
DesktopFormFactor Да Определяет параметры классического форм-фактора.
MobileFormFactor Нет Определяет параметры форм-фактора для мобильных устройств. Заметка: Этот элемент поддерживается только в Outlook для Android и iOS.
AllFormFactors Нет Определяет параметры всех форм-факторов. Используется только пользовательскими функциями в Excel.
Среды выполнения Нет Указывает среды выполнения надстройки.

xsi:type

Определяет, к какому приложению Office (Word, Excel, PowerPoint, Outlook, OneNote) применяются автономные параметры. Поддерживаются такие значения:

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

Пример ведущего приложения

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