Visão geral de ToolBar

  • Artigo

ToolBar Controles são contêineres para um grupo de comandos ou controles que normalmente estão relacionados em sua função. A ToolBar geralmente contém botões que invocam comandos.

Controle de barra de ferramentas

O ToolBar controle leva o nome da disposição em forma de barra de botões ou outros controles em uma única linha ou coluna. Os controles WPF ToolBar fornecem um mecanismo de estouro que coloca todos os itens que não se encaixam naturalmente em uma área de estouro com restrição ToolBar de tamanho em uma área de estouro especial. Além disso, os controles WPF ToolBar geralmente são usados com o controle relacionado ToolBarTray , que fornece comportamento de layout especial, bem como suporte para dimensionamento e organização de barras de ferramentas iniciados pelo usuário.

Especificando a posição das ToolBars em uma ToolBarTray

Use as Band propriedades e BandIndex para posicionar o ToolBarToolBarTrayno . Band indica a posição em que o é colocado dentro de ToolBar seu pai ToolBarTray. BandIndex indica a ordem em que o é colocado dentro de ToolBar sua faixa. O exemplo a seguir mostra como usar essa propriedade para colocar ToolBar controles dentro de um ToolBarTrayarquivo .

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

Muitas vezes ToolBar , os controles contêm mais itens do que podem caber no tamanho da barra de ferramentas. Quando isso acontece, o ToolBar exibe um botão de estouro. Para ver os itens de estouro, um usuário clica no botão de estouro e os itens são mostrados em uma janela pop-up abaixo do ToolBar. O gráfico a seguir mostra um ToolBar com itens de estouro:

Screenshot that shows a toolbar with overflow items.

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

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

O ToolBar usa a e a ToolBarOverflowPanelToolBarPanel 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 se encaixam no ToolBar. Para obter um exemplo de um ControlTemplate foro ToolBar, consulte

Estilos e modelos de ToolBar.

Confira também