コンテンツ Office アドインContent Office Add-ins

コンテンツ アドインは、Word、Excel、または PowerPoint ドキュメントに直接埋め込むことができるサーフェイスです。コンテンツ アドインにより、ユーザーはコードを実行してドキュメントを修正したり、データ ソースからデータを表示したりするインターフェイス コントロールにアクセスできます。機能を直接ドキュメントに埋め込む場合は、コンテンツ アドインを使用します。Content add-ins are surfaces that can be embedded directly into Word, Excel, or PowerPoint documents. Content add-ins give users access to interface controls that run code to modify documents or display data from a data source. Use content add-ins when you want to embed functionality directly into the document.

図 1. コンテンツ アドインの一般的なレイアウトFigure 1. Typical layout for content add-ins

コンテンツ アドインの一般的なレイアウトを表示する画像の例

ベスト プラクティスBest practices

  • アドインの上部に CommandBar や Pivot などのナビゲーション要素やコマンド要素を含めます。Include some navigational or commanding element such as the CommandBar or Pivot at the top of your add-in.
  • アドインの下部に BrandBar などのブランド化の要素を含めます (Word、Excel、および PowerPoint アドインにのみ適用)。Include a branding element such as the BrandBar at the bottom of your add-in (applies to Word, Excel, and PowerPoint add-ins only).

バリアントVariants

Office 2016 デスクトップと Office 365 の Word、Excel、PowerPoint のコンテンツ アドインのサイズはユーザーが指定します。Content add-in sizes for Word, Excel, and PowerPoint in Office 2016 desktop and Office 365 are user specified.

パーソナル メニューPersonality menu

パーソナル メニューは、アドインの右上付近にあるナビゲーション要素やコマンド要素の妨げになる可能性があります。Windows と Mac でのパーソナル メニューの現在のサイズを次に示します。Personality menus can obstruct navigational and commanding elements located near the top right of the add-in. The following are the current dimensions of the personality menu on Windows and Mac.

Windows の場合、パーソナル メニューは 12x32 ピクセルを測定します (図を参照)。For Windows, the personality menu measures 12x32 pixels, as shown.

図 2. Windows のパーソナル メニューFigure 2. Personality menu on Windows

Windows デスクトップのパーソナル メニューを示す図

Mac の場合、パーソナル メニューは 26x26 ピクセルを測定しますが、右から 8 ピクセル内側、上から 6 ピクセルの位置にフロートします。これにより、占有スペースは 34x32 ピクセルに増加します (図を参照)。For Mac, the personality menu measures 26x26 pixels, but floats 8 pixels in from the right and 6 pixels from the top, which increases the occupied space to 34x32 pixels, as shown.

図 3. Mac のパーソナル メニューFigure 3. Personality menu on Mac

Mac デスクトップのパーソナル メニューを示す図

実装Implementation

コンテンツ アドインの実装サンプルについては、GitHub の「Excel コンテンツ アドイン Humongous Insurance」を参照してください。For a sample that implements a content add-in, see Excel Content Add-in Humongous Insurance in GitHub.

サポートに関する考慮事項Support considerations

  • 使用している Office アドインが特定の Office ホスト プラットフォームで動作するかどうかを確認します。Check to see if your Office Add-in will work on a specific Office host platform.
  • コンテンツ アドインによっては、Excel または PowerPoint の読み取りと書き込みのためにユーザーがアドインを「信頼」する必要があります。Some content add-ins may require the user to "trust" the add-in to read and write to Excel or PowerPoint. アドインのマニフェストで、ユーザーに必要とされる アクセス許可のレベル を宣言することができます。You can declare what level of permissions you want your use to have in the add-in's manifest.
  • コンテンツ アドインは Office 2013 以降のバージョンの Excel および PowerPoint でサポートされています。Content add-ins are supported in Excel and PowerPoint in Office 2013 version and later. Office Web アドインをサポートしていない Office のバージョンでアドインを開くと、アドインはイメージとして表示されます。If you open an add-in in a version of Office that doesn't support Office web add-ins, the add-in will be displayed as an image.

関連項目See also