Información general sobre controles ToolBar

Los controles ToolBar son contenedores para un grupo de comandos o controles que suelen tener funciones relacionadas. ToolBar suele contener botones que invocan comandos.

Este tema contiene las secciones siguientes.

• Control ToolBar
• Especificar la posición de los controles ToolBar en un control ToolBarTray
• Controles ToolBar con elementos de desbordamiento
• Temas relacionados

Control ToolBar

El control ToolBar toma su nombre del hecho de que los botones u otros controles se organizan en forma de barra, en una sola fila o columna. Los controles WPFToolBar proporcionan un mecanismo de desbordamiento que coloca en un área de desbordamiento especial todos aquellos elementos que no caben de manera natural en un objeto ToolBar. Además, los controles ToolBar de WPF se suelen usar con el control ToolBarTray relacionado, que proporciona comportamiento de diseño especial y compatibilidad con el cambio de tamaño y la organización de barras de herramientas por parte del usuario.

Especificar la posición de los controles ToolBar en un control ToolBarTray

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

Controles ToolBar con elementos de desbordamiento

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

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 en OverflowMode.Always, OverflowMode.Never o OverflowMode.AsNeeded. En el ejemplo siguiente se especifica que los cuatro últimos botones de la barra de herramientas siempre deben estar 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 objeto ToolBarPanel y un objeto ToolBarOverflowPanel en su ControlTemplate. ToolBarPanel es responsable del diseño de los elementos en la barra de herramientas. ToolBarOverflowPanel es responsable del diseño de los elementos que no caben en ToolBar. Para obtener un ejemplo de ControlTemplate para un objeto ToolBar, consulte

Estilos y plantillas de ToolBar.

Vea también

Tareas

Cómo: Aplicar estilo a controles en un elemento ToolBar

Referencia

ToolBarPanel

ToolBarOverflowPanel

Otros recursos

Ejemplo WPF Controls Gallery