次の方法で共有


コンテンツ Office アドイン

コンテンツ アドインは、Excel または PowerPoint ドキュメントに直接埋め込むことができるサーフェイスです。 コンテンツ アドインにより、ユーザーはコードを実行してドキュメントを修正したり、データ ソースからデータを表示したりするインターフェイス コントロールにアクセスできます。 機能を直接ドキュメントに埋め込む場合は、コンテンツ アドインを使用します。

図 1. コンテンツ アドインの一般的なレイアウト

Office アプリケーションのコンテンツ アドインの一般的なレイアウト。

ベスト プラクティス

  • アドインの上部に CommandBar や Pivot などのナビゲーション要素やコマンド要素を含めます。
  • アドインの下部に BrandBar などのブランド化の要素を含めます (Excel、および PowerPoint アドインにのみ適用)。

バリエーション

Office デスクトップと Web ブラウザーの Excel およびPowerPointのコンテンツ アドイン のサイズは、ユーザーが指定します。

パーソナル メニュー

パーソナル メニューは、アドインの右上付近にあるナビゲーション要素やコマンド要素の妨げになる可能性があります。 Windows と Mac でのパーソナル メニューの現在のサイズを次に示します。

Windows の場合、パーソナル メニューは 12x32 ピクセルを測定します (図を参照)。

図 2. Windows の [パーソナリティ] メニュー

Windows デスクトップの 12 x 32 ピクセルのパーソナリティ メニュー。

Mac の場合、パーソナル メニューは 26x26 ピクセルを測定しますが、右から 8 ピクセル内側、上から 6 ピクセルの位置にフロートします。これにより、占有スペースは 34x32 ピクセルに増加します (図を参照)。

図 3. Mac の [パーソナリティ] メニュー

Mac デスクトップの 34 x 32 ピクセルのパーソナリティ メニュー。

実装

作業ウィンドウを使用するコンテンツ アドインとアドインのマニフェストには若干の違いがあります。 使用しているマニフェストの種類のタブを開きます。

注:

統合マニフェストは、Excel、PowerPoint、および開発者プレビューとしてWordで使用できます。 Outlook の場合、一般公開されており、運用アドインで使用できます。

次の手順でマニフェストを構成します。

  1. "extensions" 配列の拡張オブジェクトに "contentRuntimes" 子配列を追加します。
  2. "runtimes" プロパティが存在する場合は削除します。 "runtimes" 配列は、作業ウィンドウアドインまたはメール アドイン用です。これらはコンテンツ アドインと組み合わせることはできません。
  3. "contentRuntimes" 配列に匿名コンテンツ ランタイム オブジェクトを追加します。
  4. オブジェクトの "id" プロパティをわかりやすい名前に設定します。
  5. "code.page" オブジェクトを、ドキュメントに埋め込むカスタム コンテンツの完全な URL に設定します。
  6. 必要に応じて、"requestedWidth" プロパティと "requestedHeight" プロパティを 32 ~ 1000 ピクセルのサイズに設定します。 これらのプロパティを使用しない場合は、Office アプリケーションによってサイズが決定されます。
  7. 必要に応じて、"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 の読み取りと書き込みのためにユーザーがアドインを「信頼」する必要があります。 アドインのマニフェストには、ユーザーに必要とされるアクセス許可のレベルを宣言することができます。

関連項目