ToolBar の概要

2011-08-09

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

このトピックは、次のセクションで構成されています。

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

ToolBar コントロールという名前は、ボタンなどのコントロールが 1 つの行または列としてバーのように整列されていることに基づいています。 WPF ToolBar コントロールはオーバーフロー機構を備えており、サイズが制限されている ToolBar にそのままでは収まらない項目を、特殊なオーバーフロー領域に配置できます。また、WPF ToolBar コントロールは通常、関連する 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 のスタイルとテンプレート.

参照

次の方法で共有

ToolBar の概要

ToolBar コントロール

ToolBarTray での ToolBar の位置の指定

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

参照

処理手順

参照

その他の技術情報

その他のリソース