Freigeben über

Übersicht über ToolBar

ToolBar-Steuerelemente sind Container für eine Gruppe von Befehlen oder Steuerelementen, zwischen deren Funktionen meist ein Zusammenhang besteht. Ein ToolBar enthält in der Regel Schaltflächen, die Befehle aufrufen.

ToolBar-Steuerelement

Das ToolBar-Steuerelement hat seinen Namen von der leistenähnlichen Anordnung der Schaltflächen oder anderen Steuerelementen in einer Spalte oder einer Zeile. ToolBar-Steuerelemente in WPF bieten einen Überlaufmechanismus, der Elemente in einem speziellen Überlaufbereich platziert, die nicht in eine größenbeschränkte ToolBar passen. Darüber hinaus werden WPF-ToolBar-Steuerelemente in der Regel mit dem zugehörigen ToolBarTray-Steuerelement verwendet, das ein spezielles Layoutverhalten sowie Unterstützung für vom Benutzer initiierte Größenanpassung und Anordnung von Symbolleisten bietet.

Festlegen der Position von ToolBars in einem ToolBarTray

Verwenden Sie die Eigenschaften Band und BandIndex, um die ToolBar im ToolBarTrayzu positionieren. Band gibt die Position an, in der die ToolBar innerhalb des übergeordneten ToolBarTray platziert wird. BandIndex gibt die Reihenfolge an, in der ToolBar im Bereich platziert wird. Das folgende Beispiel zeigt, wie Sie diese Eigenschaft verwenden, um ToolBar-Steuerelemente innerhalb von ToolBarTray zu platzieren.

<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 mit Überlaufelementen

Häufig enthalten ToolBar-Steuerelemente mehr Elemente, als in die Symbolleiste passen. Wenn dies geschieht, wird ToolBar eine Überlauf-Schaltfläche angezeigen. Um die Überlaufelemente anzuzeigen, klickt ein Benutzer auf die Überlaufschaltfläche, und die Elemente werden in einem Popupfenster unterhalb der ToolBar angezeigt. Die folgende Grafik zeigt ToolBar mit Überlaufelementen:

Screenshot: Symbolleiste mit Überlaufelementen

Sie können angeben, wann ein Element auf einer Symbolleiste im Überlaufbereich platziert wird, indem Sie die angefügte Eigenschaft ToolBar.OverflowMode auf OverflowMode.Always, OverflowMode.Never oder OverflowMode.AsNeeded festlegen. Das folgende Beispiel zeigt, dass sich die letzten vier Schaltflächen auf der Symbolleiste immer im Überlaufpanel befinden sollen.

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

Die ToolBar verwendet eine ToolBarPanel und eine ToolBarOverflowPanel in ControlTemplate. Der ToolBarPanel ist für das Layout der Elemente in der Symbolleiste verantwortlich. Der ToolBarOverflowPanel ist verantwortlich für das Layout der Artikel, die nicht auf die ToolBar passen. Ein Beispiel zu ControlTemplate für ToolBar finden Sie unter

ToolBar-Stile und -Vorlagen

Siehe auch