Übersicht überToolBar

ToolBar-Steuerelemente sind Container für eine Gruppe von Befehlen oder Steuerelementen, die in der Regel verwandte Funktionen aufweisen. Eine ToolBar enthält normalerweise Schaltflächen, die Befehle aufrufen.

Dieses Thema enthält folgende Abschnitte.

• ToolBar-Steuerelement
• Angeben der Position von ToolBar-Elementen in einem ToolBarTray
• ToolBar-Elemente mit Überlaufelementen
• Verwandte Abschnitte

ToolBar-Steuerelement

Das ToolBar-Steuerelement bezieht seinen Namen von der symbolleistenähnlichen Anordnung von Schaltflächen oder anderen Steuerelementen in einer einzelnen Zeile oder Spalte. WPF ToolBar-Steuerelemente bieten einen Überlaufmechanismus, der alle Elemente, die nicht auf natürliche Weise in ein größenbeschränktes ToolBar-Objekt passen, in einem speziellen Überlaufbereich platziert. Des Weiteren werden WPF ToolBar-Steuerelemente in der Regel mit dem verwandten ToolBarTray-Steuerelement verwendet, das ein spezielles Layoutverhalten aufweist und Unterstützung für vom Benutzer initiierte Größenänderungen und Anordnungen von Symbolleisten bietet.

Angeben der Position von ToolBar-Elementen in einem ToolBarTray

Mit den Eigenschaften Band und BandIndex positionieren Sie das ToolBar-Element im ToolBarTray-Element. Band gibt die Position an, an der das ToolBar-Element im übergeordneten ToolBarTray-Element positioniert wird. BandIndex gibt die Reihenfolge an, in der das ToolBar-Element innerhalb des zugehörigen Bands platziert wird. Im folgenden Beispiel wird veranschaulicht, wie diese Eigenschaft zum Platzieren von ToolBar-Steuerelementen in einem ToolBarTray verwendet wird.

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

ToolBar-Elemente mit Überlaufelementen

Oft enthalten ToolBar-Steuerelemente mehr Elemente als in die Größe der Symbolleiste passen. In diesem Fall wird in der ToolBar eine Überlaufschaltfläche angezeigt. Um die Überlaufelemente anzuzeigen, klickt ein Benutzer auf die Überlaufschaltfläche. Die Elemente werden dann in einem Popupfenster unter der ToolBar angezeigt. Die folgende Grafik zeigt eine ToolBar mit Überlaufelementen.

Symbolleiste mit Überlaufelementen

Sie können angeben, wann ein Element einer Symbolleiste im Überlaufbereich platziert wird, indem Sie die angehängte ToolBar.OverflowMode-Eigenschaft auf OverflowMode.Always, OverflowMode.Never oder OverflowMode.AsNeeded festlegen. Im folgenden Beispiel wird angegeben, dass die letzten vier Schaltflächen der Symbolleiste immer im Überlaufbereich platziert werden.

<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 in ihrer ControlTemplate einen ToolBarPanel und einen ToolBarOverflowPanel. Der ToolBarPanel ist für das Layout der Elemente auf der Symbolleiste verantwortlich. Der ToolBarOverflowPanel ist für das Layout der Elemente verantwortlich, die nicht auf die ToolBar passen. Ein ControlTemplate-Beispiel für eine ToolBar finden Sie unter

ToolBar-Stile und -Vorlagen.

Siehe auch

Aufgaben

Gewusst wie: Formatieren von Steuerelementen auf einer Symbolleiste

Referenz

ToolBarPanel

ToolBarOverflowPanel

Weitere Ressourcen

Beispiel für WPF-Steuerelementsammlungen