Compartilhar via

Visão geral da Barra de Ferramentas

Os controles ToolBar são contêineres para um grupo de comandos ou controles que normalmente estão relacionados em suas finalidades. Um ToolBar geralmente contém botões que invocam comandos.

Controle da Barra de Ferramentas

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

Especificando a posição das Barras de Ferramentas em um ToolBarTray

Use as propriedades Band e BandIndex para posicionar o ToolBar no ToolBarTray. Band indica a posição na qual o ToolBar é colocado dentro do respectivo ToolBarTray pai. BandIndex indica a ordem na qual o ToolBar é colocado dentro de sua banda. O exemplo a seguir mostra como usar essa propriedade para colocar controles ToolBar dentro de um 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>

Barras de Ferramentas com Itens em Excesso

Geralmente, ToolBar 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 excedentes, o usuário clica no botão de excedente e os itens são mostrados em um pop-up abaixo do ToolBar. O gráfico a seguir mostra um ToolBar com itens excedentes.

Captura de tela que mostra uma barra de ferramentas com itens de estouro.

Você pode especificar quando um item em uma barra de ferramentas é colocado no painel de transbordamento 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 ToolBarPanel e 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 se encaixam no ToolBar. Para obter um exemplo de um ControlTemplate para um ToolBar, consulte

Estilos e modelos de ToolBar.

Consulte também

  • Last updated on