Condividi tramite

Panoramica della barra degli strumenti

  • Articolo

I controlli ToolBar sono dei contenitori per un gruppo di comandi o controlli, che di solito sono correlati nella loro funzione. Un ToolBar in genere contiene pulsanti che richiamano i comandi.

Controllo della Barra degli Strumenti

Il controllo ToolBar prende il nome dalla disposizione simile a una barra dei pulsanti o di altri controlli in una singola riga o colonna. I controlli ToolBar WPF forniscono un meccanismo di overflow che inserisce tutti gli elementi che non rientrano naturalmente in un ToolBar vincolato di dimensioni in un'area speciale di overflow. Inoltre, i controlli ToolBar WPF vengono in genere usati con il controllo ToolBarTray correlato, che fornisce un comportamento di layout speciale, nonché il supporto per il ridimensionamento e la disposizione delle barre degli strumenti avviate dall'utente.

Specificare la posizione delle barre degli strumenti in un ToolBarTray

Utilizzare le proprietà Band e BandIndex per posizionare il ToolBar nella ToolBarTray. Band indica la posizione in cui il ToolBar viene posizionato all'interno del relativo ToolBarTraypadre. BandIndex indica l'ordine in cui il ToolBar viene posizionato all'interno della relativa banda. Nell'esempio seguente viene illustrato come utilizzare questa proprietà per inserire ToolBar controlli all'interno di 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>

Barre degli strumenti con elementi in eccesso

Spesso i controlli ToolBar contengono più elementi di quelli che possono entrare nelle dimensioni della barra degli strumenti. In questo caso, il ToolBar visualizza un pulsante di overflow. Per visualizzare gli elementi di overflow, un utente fa clic sul pulsante di overflow e gli elementi vengono visualizzati in una finestra popup sotto il ToolBar. L'immagine seguente mostra un ToolBar con elementi in eccedenza.

Screenshot che mostra una barra degli strumenti con elementi di overflow.

È possibile specificare quando un elemento su una barra degli strumenti viene posizionato nel pannello di overflow impostando la proprietà associata ToolBar.OverflowMode su OverflowMode.Always, OverflowMode.Nevero OverflowMode.AsNeeded. Nell'esempio seguente viene specificato che gli ultimi quattro pulsanti sulla barra degli strumenti devono sempre trovarsi nel pannello di overflow.

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

Il ToolBar usa un ToolBarPanel e un ToolBarOverflowPanel nel suo ControlTemplate. Il ToolBarPanel è responsabile del layout degli elementi sulla barra degli strumenti. Il ToolBarOverflowPanel è responsabile del layout degli elementi che non rientrano nel ToolBar. Per un esempio di ControlTemplate per un ToolBar, vedere

Stili e modelli della Barra degli strumenti.

Vedere anche