工具列概觀

發行項
08/21/2008

更新：2007 年 11 月

ToolBar 控制項是包含一組命令或控制項的容器，這些命令或控制項通常與其功能相關。ToolBar 通常包含會叫用 (Invoke) 命令的按鈕。

這個主題包含下列章節。

工具列控制項
指定工具列在 ToolBarTray 中的位置
具有溢位項目的工具列
相關主題

工具列控制項

ToolBar 控制項得名於其將按鈕或其他控制項置於單列或單欄中的條狀排列。WPFToolBar 控制項提供溢位機制，可以將不能自然放入具有大小限制的 ToolBar 的項目，放置到特別的溢位區域。同時，WPFToolBar 控制項通常會與相關的 ToolBarTray 控制項一起使用，以提供特殊的配置行為並支援使用者啟始的工具列大小設定及排列。

指定工具列在 ToolBarTray 中的位置

使用 Band 和 BandIndex 屬性以指定 ToolBar 在 ToolBarTray 中的位置。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 底下的快顯視窗 (Pop-Up Window)。下圖顯示具有溢位項目的 ToolBar。

具有溢位項目的工具列

包含超出項目的工具列

您可以指定工具列上的項目放置到溢位面板的時機，方法是將 ToolBar.OverflowMode 附加屬性設為 OverflowMode.Always、OverflowMode.Never 或 OverflowMode.AsNeeded。下列範例會指定工具列上的最後四個按鈕應該一律位在溢位面板上。

<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 範例