Partager via

Vue d’ensemble de la barre d’outils

  • Article

Les contrôles ToolBar sont des conteneurs pour un groupe de commandes ou de contrôles dont les fonctions sont généralement liées. Un ToolBar contient généralement des boutons qui appellent des commandes.

Contrôle de la barre d'outils

Le contrôle ToolBar prend son nom à partir de la disposition de barres de boutons ou d’autres contrôles dans une seule ligne ou colonne. Les contrôles WPF ToolBar fournissent un mécanisme de dépassement de capacité qui place les éléments qui ne s’intègrent pas naturellement dans une ToolBar contrainte de taille dans une zone de dépassement de capacité spéciale. En outre, les contrôles ToolBar WPF sont généralement utilisés avec le contrôle ToolBarTray associé, qui fournit un comportement de disposition spécial, ainsi que la prise en charge du dimensionnement initié par l’utilisateur et de l’organisation des barres d’outils.

Spécification de la position des barres d’outils dans un ToolBarTray

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

Barres d’outils avec éléments supplémentaires

Souvent, les contrôles ToolBar contiennent plus d'éléments que ce qui peut être contenu dans la taille de la barre d'outils. Lorsque cela se produit, le ToolBar affiche un bouton de dépassement de capacité. Pour afficher les éléments supplémentaires, un utilisateur clique sur le bouton de débordement, et les éléments sont affichés dans une fenêtre contextuelle située sous le ToolBar. Le graphique suivant montre un ToolBar avec des éléments en surplus :

Capture d’écran montrant une barre d’outils avec des éléments supplémentaires.

Vous pouvez spécifier quand un élément d’une barre d’outils est affiché sur le panneau de trop-plein en définissant la propriété attachée ToolBar.OverflowMode à OverflowMode.Always, OverflowMode.Neverou OverflowMode.AsNeeded. L’exemple suivant spécifie que les quatre derniers boutons de la barre d’outils doivent toujours se trouver dans 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. La ToolBarPanel est responsable de la disposition des éléments de la barre d’outils. La ToolBarOverflowPanel est responsable de la disposition des éléments qui ne tiennent pas sur le ToolBar. Pour obtenir un exemple de ControlTemplate pour un ToolBar, consultez

Styles et modèles de barre d’outils.

Voir aussi