Compartir a través de

Información general sobre la barra de herramientas

ToolBar los controles son contenedores para un grupo de comandos o controles que normalmente están relacionados con su función. Normalmente ToolBar contiene botones que invocan comandos.

Control de Barra de Herramientas

El ToolBar control toma su nombre de la disposición similar a la barra de botones u otros controles en una sola fila o columna. Los controles WPF ToolBar proporcionan un mecanismo de desbordamiento que coloca los elementos que no encajan naturalmente dentro de un tamaño restringido ToolBar en un área de desbordamiento especial. Además, los controles WPF ToolBar se suelen usar con el control relacionado ToolBarTray , que proporciona un comportamiento de diseño especial, así como compatibilidad con el ajuste de tamaño iniciado por el usuario y la organización de barras de herramientas.

Especificar la posición de las barras de herramientas en un ToolBarTray

Usa las propiedades Band y BandIndex para colocar el ToolBar en el ToolBarTray. Band indica la posición en la que se coloca la ToolBar dentro de su elemento primario ToolBarTray. BandIndex indica el orden en el que ToolBar se coloca dentro de su banda. En el ejemplo siguiente se muestra cómo usar esta propiedad para colocar ToolBar controles dentro de .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 herramientas con elementos adicionales

A menudo ToolBar , los controles contienen más elementos de los que pueden ajustarse al tamaño de la barra de herramientas. Cuando esto sucede, ToolBar muestra un botón de desbordamiento. Para ver los elementos de desbordamiento, un usuario hace clic en el botón de desbordamiento y los elementos se muestran en una ventana emergente debajo de ToolBar. En el gráfico siguiente se muestra un ToolBar con elementos de desbordamiento.

Captura de pantalla que muestra una barra de herramientas con elementos de desbordamiento.

Puede especificar cuándo se coloca un elemento de una barra de herramientas en el panel de desbordamiento estableciendo la propiedad adjunta ToolBar.OverflowMode a OverflowMode.Always, OverflowMode.Never o OverflowMode.AsNeeded. En el ejemplo siguiente se especifica que los cuatro últimos botones de la barra de herramientas deben estar siempre en el panel de desbordamiento.

<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 utiliza un ToolBarPanel y un ToolBarOverflowPanel en su ControlTemplate. El ToolBarPanel es responsable del diseño de los elementos de la barra de herramientas. ToolBarOverflowPanel es responsable del diseño de los elementos que no caben en el ToolBar. Para obtener un ejemplo de ControlTemplate para un ToolBar, vea

Estilos y plantillas de la barra de herramientas.

Consulte también