ToolBar の概要

[アーティクル]
08/16/2008

更新 : 2007 年 11 月

ToolBar コントロールは、通常は関連性のある機能を持つコマンドまたはコントロールのグループのコンテナです。ToolBar には、通常はコマンドを呼び出すボタンが格納されています。

このトピックには次のセクションが含まれています。

ToolBar コントロール
ToolBarTray での ToolBar の位置の指定
オーバーフロー項目を持つ ToolBar
関連トピック

ToolBar コントロールという名前は、ボタンなどのコントロールが 1 つの行または列としてバーのように整列されていることに基づいています。WPFToolBar コントロールはオーバーフロー機構を備えており、サイズが制限されている ToolBar にそのままでは収まらない項目を、特殊なオーバーフロー領域に配置できます。また、WPFToolBar コントロールは通常、関連する ToolBarTray コントロールと共に使用されます。これは、ユーザーによるツールバーのサイズ変更や配置のサポートだけでなく、特殊なレイアウト動作も提供します。

Band プロパティと BandIndex プロパティは、ToolBarTray に ToolBar を配置するために使用します。Band は、ToolBar がその親 ToolBarTray 内で配置される位置を示します。BandIndex は、ToolBar がそのバンド内で配置される順序を示します。このプロパティを使用して ToolBar コントロールを ToolBarTray 内に配置する方法を次の例に示します。

<ToolBarTray Background="White">
  <ToolBar Band="1" BandIndex="1">
    <Button>
      <Image Source="toolbargraphics\cut.bmp" />
    </Button>
    <Button>
      <Image Source="toolbargraphics\copy.bmp" />
    </Button>
    <Button>
      <Image Source="toolbargraphics\paste.bmp" />
    </Button>
  </ToolBar>
  <ToolBar Band="2" BandIndex="1">
    <Button>
      <Image Source="toolbargraphics\undo.bmp" />
    </Button>
    <Button>
      <Image Source="toolbargraphics\redo.bmp" />
    </Button>
  </ToolBar>
  <ToolBar Band="2" BandIndex="2">
    <Button>
      <Image Source="toolbargraphics\paint.bmp" />
    </Button>
    <Button>
      <Image Source="toolbargraphics\spell.bmp" />
    </Button>
    <Separator/>
    <Button>
      <Image Source="toolbargraphics\save.bmp" />
    </Button>
    <Button>
      <Image Source="toolbargraphics\open.bmp" />
    </Button>
  </ToolBar>
</ToolBarTray>

ToolBar コントロールに含まれる項目の数が多いために、ツールバーのサイズに収まらないことがあります。そのような場合は、ToolBar にオーバーフローボタンが表示されます。オーバーフロー項目を確認するには、オーバーフローボタンをクリックし、ToolBar の下のポップアップウィンドウに項目を表示します。次の図は、オーバーフロー項目を含む ToolBar を示しています。

オーバーフロー項目を持つ ToolBar

オーバーフローを含むツールバー

ツールバーの項目がオーバーフローパネルに配置されるタイミングを設定するには、ToolBar.OverflowMode 添付プロパティを OverflowMode.Always、OverflowMode.Never、または OverflowMode.AsNeeded に設定します。次の例は、ツールバーの最後の 4 つのボタンが常にオーバーフローパネル上に存在するように指定しています。

<ToolBarTray Background="White">
  <ToolBar Band="1" BandIndex="1">
    <Button>
      <Image Source="toolbargraphics\cut.bmp" />
    </Button>
    <Button>
      <Image Source="toolbargraphics\copy.bmp" />
    </Button>
    <Button>
      <Image Source="toolbargraphics\paste.bmp" />
    </Button>
    <Button>
      <Image Source="toolbargraphics\undo.bmp" />
    </Button>
    <Button>
      <Image Source="toolbargraphics\redo.bmp" />
    </Button>
    <Button>
      <Image Source="toolbargraphics\paint.bmp" />
    </Button>
    <Button>
      <Image Source="toolbargraphics\spell.bmp" />
    </Button>
    <Separator/>
    <Button ToolBar.OverflowMode="Always">
      <Image Source="toolbargraphics\save.bmp" />
    </Button>
    <Button ToolBar.OverflowMode="Always">
      <Image Source="toolbargraphics\open.bmp" />
    </Button>
    <Button ToolBar.OverflowMode="Always">
      <Image Source="toolbargraphics\print.bmp" />
    </Button>
    <Button ToolBar.OverflowMode="Always">
      <Image Source="toolbargraphics\preview.bmp" />
    </Button>
  </ToolBar>
</ToolBarTray>

ToolBar は、その ControlTemplate で、ToolBarPanel と ToolBarOverflowPanel を使用します。ToolBarPanel は、ツールバー上の項目のレイアウトを制御します。ToolBarOverflowPanel は、ToolBar に収まらない項目のレイアウトを制御します。ToolBar の ControlTemplate の例については、次のトピックを参照してください。

ToolBar ControlTemplate の例.