Office アドインの作業ウィンドウTask panes in Office Add-ins

作業ウィンドウは、通常 Word、PowerPoint、Excel、Outlook 内のウィンドウの右側に表示されるインターフェイスのサーフェスです。作業ウィンドウにより、ユーザーはコードを実行してドキュメントや電子メールを修正したり、データ ソースからデータを表示したりするインターフェイス コントロールにアクセスできます。機能を直接ドキュメントに埋め込む必要がない場合は、作業ウィンドウを使用します。Task panes are interface surfaces that typically appear on the right side of the window within Word, PowerPoint, Excel, and Outlook. Task panes give users access to interface controls that run code to modify documents or emails, or display data from a data source. Use task panes when you don't need to embed functionality directly into the document.

図 1. 一般的な作業ウィンドウのレイアウトFigure 1. Typical task pane layout

一般的な作業ウィンドウのレイアウトを表示するイメージ

ベスト プラクティスBest practices

するべきことDo してはいけないことDon't
  • タイトルにアドインの名前を含めます。Include the name of your add-in in the title.
  • タイトルには会社名を追加しません。Don't append your company name to the title.
  • タイトルには短い説明的な名前を使用します。Use short descriptive names in the title.
  • アドインのタイトルに “Add-in”、“For Word”、“for Office” などの文字列を追加しません。Don't append strings such as “Add-in,” “For Word,” or “for Office” to the title of your add-in.
  • アドインの上部に CommandBar や Pivot などのナビゲーション要素やコマンド要素を含めます。Include some navigational or commanding element such as the CommandBar or Pivot at the top of your add-in.
  • アドインを Outlook 内で使用する場合を除き、アドインの下部に BrandBar などのブランド化の要素を含めます。Include a branding element such as the BrandBar at the bottom of your add-in unless your add-in is to be used within Outlook.

バリアントVariants

以下の図は、Office リボンの解像度が 1366x768 のさまざまな作業ウィンドウのサイズを示しています。Excel では、数式バーを収容するための縦のスペースが必要です。The following images show the various task pane sizes with the Office ribbon at a 1366x768 resolution. For Excel, additional vertical space is required to accommodate the formula bar.

図 2. Office 2016 デスクトップ作業ウィンドウのサイズFigure 2. Office 2016 desktop task pane sizes

1366x768 のデスクトップ作業ウィンドウのサイズを示す図

  • Excel - 320x455Excel - 320x455
  • PowerPoint - 320x531PowerPoint - 320x531
  • Word - 320x531Word - 320x531
  • Outlook - 348x535Outlook - 348x535


図 3. Office 365 の作業ウィンドウのサイズFigure 3. Office 365 task pane sizes

1366x768 のデスクトップ作業ウィンドウのサイズを示す図

  • Excel - 350x378Excel - 350x378
  • PowerPoint - 348x391PowerPoint - 348x391
  • Word - 329x445Word - 329x445
  • Outlook Web App - 320x570Outlook Web App - 320x570

パーソナル メニュー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.

図 4. Windows のパーソナル メニューFigure 4. 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 space to 34x32 pixels, as shown.

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

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

実装Implementation

作業ウィンドウを実装するサンプルについては、GitHub の「Excel アドインの JS WoodGrove Expense Trends」を参照してください。For a sample that implements a task pane, see Excel Add-in JS WoodGrove Expense Trends on GitHub.

関連項目See also