ToolBar Overview

Artigo
08/25/2010

Controles ToolBar são contêineres para um grupo de comandos ou controles que normalmente têm funçóes relacionadas. Uma ToolBar normalmente contém botões que chamam comandos.

Este tópico contém as seguintes seções.

Controle ToolBar
Especificando a posição de ToolBars em uma ToolBarTray
ToolBars com itens excedentes
Tópicos relacionados

The ToolBar controle se o seu nome da organização semelhante à BAR de botões ou outros controles em uma única linha ou coluna. WPF ToolBar controls provide an overflow mechanism which places any items that do not fit naturally within a size-constrained ToolBar into a special overflow area. Além disso, controles ToolBar no WPF são normalmente usados com o um controle relacionado, ToolBarTray, que fornece comportamento especial de layout bem como suporte para o usuário inicie um dimensionamento ou uma disposição das barras de ferramentas.

Especificando a posição de ToolBars em uma ToolBarTray

Use o Band e BandIndex propriedades para posicionar o ToolBar no ToolBarTray. Band indica a posição em que o ToolBar é colocado dentro de seu pai ToolBarTray. BandIndex indica a ordem na qual o ToolBar é colocado dentro de sua banda. O exemplo a seguir mostra como usar esta propriedade para posicionar controles ToolBar em uma 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>

ToolBars com itens excedentes

É frequente encontrar controles ToolBar que contêm mais itens do que a quantidade comportada pelo tamanho da barra de ferramentas. Quando isso acontece, a ToolBar exibe um botão de itens excedentes. Para ver os itens excedentes, um usuário clica no botão de excedentes e os itens são mostrados em uma janela pop-up abaixo da ToolBar. O gráfico a seguir mostra uma ToolBar com itens excedentes.

ToolBar com itens excedentes

ToolBar com estouro

Você pode especificar quando um item em uma barra de ferramentas é colocado em um painel de excedentes definindo a propriedade anexada ToolBar.OverflowMode como OverflowMode.Always, OverflowMode.Never, ou OverflowMode.AsNeeded. O exemplo a seguir especifica que os últimos quatro botões na barra de ferramentas devem estar sempre no painel de excedentes.

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

A ToolBar usa um ToolBarPanel e um ToolBarOverflowPanel em seu ControlTemplate. O ToolBarPanel é responsável pelo layout dos itens na barra de ferramentas. O ToolBarOverflowPanel é responsável pelo layout dos itens que não cabem na ToolBar. Para ver um exemplo de um ControlTemplate para uma ToolBar, consulte

Exemplo de ControlTemplae de ToolBar.