Host 要素
アドインでアクティブ化する Office アプリケーションの種類を個別に指定します。
重要
<Host> 要素の構文は、要素が基本マニフェスト内で定義されているか、VersionOverrides ノード内で定義されているかによって異なります。 ただし、機能は変わりません。
基本のマニフェスト
基本のマニフェストで定義されている場合 (OfficeApp の下)、ホストの種類は Name
属性によって決定されます。
属性
属性 | 種類 | 必須 | 説明 |
---|---|---|---|
名前 | 文字列 | はい | Office クライアント アプリケーションの種類の名前。 |
名前
このアドインが対象にするホストの種類を指定します。 この値は、次のいずれかである必要があります。
-
Document
(Word) -
Mailbox
(Outlook) -
Notebook
(OneNote) -
Presentation
(PowerPoint) -
Project
(Project) -
Workbook
(Excel) -
Database
(Access (obsolete))
例
<Hosts>
<Host Name="Mailbox">
</Host>
</Hosts>
VersionOverrides ノード
VersionOverrides で定義されている場合、ホストの種類は xsi:type
属性によって決定されます。
この要素は、基本マニフェストの <Hosts> 要素をオーバーライドします。
アドインの種類: 作業ウィンドウ、メール
次の VersionOverrides スキーマでのみ有効です:
- 作業ウィンドウ 1.0
- メール 1.0
- メール 1.1
詳細については、「 アドインのみのマニフェストでのバージョンのオーバーライド」を参照してください。
属性
属性 | 必須 | 説明 |
---|---|---|
xsi:type | はい | これらの設定が適用される Office アプリケーションを指定します。 |
子要素
要素 | 必須 | 説明 |
---|---|---|
DesktopFormFactor | はい | デスクトップ フォーム ファクターの設定を定義します。 |
MobileFormFactor | いいえ | モバイル フォーム ファクターの設定を定義します。 手記: この要素は、Outlook on 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>
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
Office Add-ins