Verktygsfält

Den ToolBar kontrollen är en container för en grupp kommandon eller kontroller som vanligtvis är relaterade till deras funktion. Den innehåller vanligtvis knappar som anropar kommandon och ordnar dem i en stapelliknande layout till en enskild rad eller kolumn.

Kontrollen ToolBar tillhandahåller en spillmekanism som placerar objekt som inte får plats i ett storleksbegränsat verktygsfält i ett särskilt spillområde. Du använder vanligtvis ToolBar-kontroller med den relaterade ToolBarTray-kontrollen, vilket ger ett särskilt layoutbeteende och stöder användarinitierad storleksändring och ordnande av verktygsfältet.

Placera verktygslister i en ToolBarTray

Använd egenskaperna Band och BandIndex för att placera ToolBar i ToolBarTray. Egenskapen Band anger positionen där ToolBar är placerad inom dess överordnade ToolBarTray. Egenskapen BandIndex anger den ordning där ToolBar är placerad inom dess band. I följande exempel visas hur du använder dessa egenskaper för att placera ToolBar kontroller i en 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>

Hantera spillobjekt

En ToolBar kontroll innehåller ofta fler objekt än vad som får plats i verktygsfältets storlek. När så sker visar verktygsfältet en överflödesknapp. Om du vill se spillobjekten klickar du på spillknappen och objekten visas i ett popup-fönster under verktygsfältet. Följande bild visar ett verktygsfält med överflödiga objekt.

Kontrollera när ett objekt i ett verktygsfält placeras på spillpanelen genom att ange den ToolBar.OverflowMode bifogade egenskapen till OverflowMode.Always, OverflowMode.Never, eller OverflowMode.AsNeeded. I följande exempel anges att de fyra sista knapparna på verktygsfältet alltid ska finnas på överflödspanelen.

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

Det ToolBar använder en ToolBarPanel och en ToolBarOverflowPanel i dess ControlTemplate. ToolBarPanel hanterar layouten för objekten i verktygsfältet. Det ToolBarOverflowPanel hanterar layouten för de objekt som inte får plats i verktygsfältet.

Formatmallar och stilar

Du kan ändra standardvärdet ControlTemplate för att ge kontrollen ett unikt utseende. Mer information finns i Vad är formatmallar och mallar? och Hur skapar du en mall för en kontroll.

Innehållsegenskap

Kontrollen ToolBar använder egenskapen Items som dess innehållsegenskap. Med den här egenskapen kan du lägga till underordnade objekt i verktygsfältet, som vanligtvis är knappar eller andra kontroller som anropar kommandon.

Delar

I följande tabell visas de namngivna ToolBar delarna för kontrollen.

När du skapar en ControlTemplate för en ToolBarkan mallen innehålla en ItemsPresenter i en ScrollViewer. Visar ItemsPresenter varje objekt i verktygsfältet och ScrollViewer aktiverar rullning i kontrollen. Om ItemsPresenter inte är direktavkomma av ScrollViewer, måste du ge ItemsPresenter namnet ItemsPresenter.

Visuella tillstånd

Den här kontrollen definierar inga visuella tillstånd.

Se även

• Formatkontroller i ett verktygsfält
• Galleriexempel för WPF-kontroller
• ToolBarOverflowPanel
• ToolBarPanel
• ToolBar
• ToolBarTray