Vue d'ensemble de ToolBar

Article
08/22/2008

Mise à jour : novembre 2007

Les contrôles ToolBar sont les conteneurs d'un groupe de commandes ou des contrôles généralement associés dans leur fonction. Un ToolBar contient généralement des boutons qui appellent des commandes.

Cette rubrique comprend les sections suivantes.

Contrôle ToolBar
Spécification de la position de Toolbars dans un ToolBarTray
ToolBars avec éléments de dépassement de capacité
Rubriques connexes

Le contrôle ToolBar tire son nom de l'organisation sous forme de barre des boutons ou d'autres contrôles dans une seule ligne ou colonne. Les contrôles WPFToolBar fournissent un mécanisme de dépassement qui place les éléments qui ne sont pas adaptés naturellement dans un ToolBar à contrainte de taille dans une zone de dépassement spéciale. En outre, les contrôles WPFToolBar sont habituellement utilisés avec le contrôle ToolBarTray associé, qui fournit un comportement de disposition spécial, ainsi qu'une prise en charge du dimensionnement et de l'organisation des barres d'outils initiés par l'utilisateur.

Spécification de la position de Toolbars dans un ToolBarTray

Utilisez les propriétés Band et BandIndex pour positionner le ToolBar dans le ToolBarTray. Band indique la position à laquelle le ToolBar est placé dans son ToolBarTray parent. BandIndex indique l'ordre dans lequel le ToolBar est placé dans sa bande. L'exemple suivant indique comment utiliser cette propriété pour placer des contrôles ToolBar dans un 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>

ToolBars avec éléments de dépassement de capacité

Les contrôles ToolBar contiennent souvent un nombre d'éléments supérieur à la capacité de la barre d'outils. Lorsque cela se produit, le ToolBar affiche un bouton de dépassement de capacité. Pour afficher les éléments de dépassement de capacité, cliquez sur le bouton de dépassement de capacité et les éléments apparaissent dans une fenêtre indépendante sous le ToolBar. Le graphique suivant illustre un ToolBar avec des éléments de dépassement de capacité.

ToolBars avec éléments de dépassement de capacité

Barre d'outils avec dépassement de capacité

Vous pouvez spécifier à quel moment un élément d'une barre d'outils est placé sur le panneau de dépassement de capacité en affectant OverflowMode.Always, OverflowMode.Never ou OverflowMode.AsNeeded à la propriété ToolBar.OverflowMode attachée. L'exemple suivant spécifie que les quatre derniers boutons sur la barre d'outils doivent toujours être placés sur le panneau de dépassement de capacité.

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

Le ToolBar utilise un ToolBarPanel et un ToolBarOverflowPanel dans son ControlTemplate. Le ToolBarPanel est responsable de la disposition des éléments sur la barre d'outils. Le ToolBarOverflowPanel est responsable de la disposition des éléments qui ne tiennent pas sur le ToolBar. Pour obtenir un exemple d'un ControlTemplate pour un ToolBar, consultez

ToolBar ControlTemplate, exemple.