コンテンツ Office アドイン
コンテンツ アドインは、Excel または PowerPoint ドキュメントに直接埋め込むことができるサーフェイスです。 コンテンツ アドインにより、ユーザーはコードを実行してドキュメントを修正したり、データ ソースからデータを表示したりするインターフェイス コントロールにアクセスできます。 機能を直接ドキュメントに埋め込む場合は、コンテンツ アドインを使用します。
図 1. コンテンツ アドインの一般的なレイアウト
ベスト プラクティス
- アドインの上部に CommandBar や Pivot などのナビゲーション要素やコマンド要素を含めます。
- アドインの下部に BrandBar などのブランド化の要素を含めます (Excel、および PowerPoint アドインにのみ適用)。
バリエーション
Office デスクトップと Web ブラウザーの Excel およびPowerPointのコンテンツ アドイン のサイズは、ユーザーが指定します。
パーソナル メニュー
パーソナル メニューは、アドインの右上付近にあるナビゲーション要素やコマンド要素の妨げになる可能性があります。 Windows と Mac でのパーソナル メニューの現在のサイズを次に示します。
Windows の場合、パーソナル メニューは 12x32 ピクセルを測定します (図を参照)。
図 2. Windows の [パーソナリティ] メニュー
Mac の場合、パーソナル メニューは 26x26 ピクセルを測定しますが、右から 8 ピクセル内側、上から 6 ピクセルの位置にフロートします。これにより、占有スペースは 34x32 ピクセルに増加します (図を参照)。
図 3. Mac の [パーソナリティ] メニュー
実装
作業ウィンドウを使用するコンテンツ アドインとアドインのマニフェストには若干の違いがあります。 使用しているマニフェストの種類のタブを開きます。
注:
統合マニフェストは、Excel、PowerPoint、および開発者プレビューとしてWordで使用できます。 Outlook の場合、一般公開されており、運用アドインで使用できます。
次の手順でマニフェストを構成します。
- "extensions" 配列の拡張オブジェクトに "contentRuntimes" 子配列を追加します。
- "runtimes" プロパティが存在する場合は削除します。 "runtimes" 配列は、作業ウィンドウアドインまたはメール アドイン用です。これらはコンテンツ アドインと組み合わせることはできません。
- "contentRuntimes" 配列に匿名コンテンツ ランタイム オブジェクトを追加します。
- オブジェクトの "id" プロパティをわかりやすい名前に設定します。
- "code.page" オブジェクトを、ドキュメントに埋め込むカスタム コンテンツの完全な URL に設定します。
- 必要に応じて、"requestedWidth" プロパティと "requestedHeight" プロパティを 32 ~ 1000 ピクセルのサイズに設定します。 これらのプロパティを使用しない場合は、Office アプリケーションによってサイズが決定されます。
- 必要に応じて、"disableSnapshot" プロパティを
trueに設定して、Office がドキュメントにコンテンツ コンポーネントのスナップショットを保存できないようにします。
"contentRuntimes" プロパティの例を次に示します。
"contentRuntimes": [
{
"id": "ContentRuntime",
"code": {
"page": "https://localhost:3000/content.html"
},
"requestedWidth": 100,
"requestedHeight": 100,
"disableSnapshot": true,
}
]
コンテンツ アドインを実装するサンプルについては、GitHub の 「Excel コンテンツ アドイン Humongous Insurance 」を参照してください。
独自のコンテンツ アドインを作成するには、 Excel コンテンツ アドインのクイック スタート とコンテンツ アドインの クイック スタートPowerPoint参照してください。
サポートに関する考慮事項
- Office アドインが特定の Office アプリケーションまたはプラットフォームで動作するかどうかを確認します。
- コンテンツ アドインによっては、Excel または PowerPoint の読み取りと書き込みのためにユーザーがアドインを「信頼」する必要があります。 アドインのマニフェストには、ユーザーに必要とされるアクセス許可のレベルを宣言することができます。
関連項目
Office Add-ins