Bilah Alat

Kontrol ToolBar adalah kontainer untuk sekelompok perintah atau kontrol yang biasanya terkait dalam fungsinya. Biasanya berisi tombol yang memanggil perintah dan mengaturnya dalam tata letak seperti batang ke dalam satu baris atau kolom.

Cuplikan layar toolbar horizontal di WPF.

Kontrol ToolBar menyediakan mekanisme luapan yang menempatkan item yang tidak pas dalam toolbar yang dibatasi ukuran ke area luapan khusus. Anda biasanya menggunakan kontrol ToolBar dengan kontrol terkait ToolBarTray, yang menyediakan perilaku tata letak khusus dan mendukung pengaturan ukuran dan penataan toolbar yang diprakarsai oleh pengguna.

Posisi Bilah Alat di ToolBarTray

Gunakan properti Band dan BandIndex untuk memposisikan ToolBar di ToolBarTray. Properti Band menunjukkan posisi tempat ToolBar ditempatkan dalam induknya ToolBarTray. Properti BandIndex menunjukkan urutan tempat ToolBar ditempatkan dalam pitanya. Contoh berikut menunjukkan cara menggunakan properti ini untuk menempatkan ToolBar kontrol di dalam 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>

Menangani item luapan

ToolBar Kontrol sering berisi lebih banyak item daripada yang dapat muat dalam ukuran bilah alat. Saat ini terjadi, toolbar menampilkan tombol overflow. Untuk melihat item luapan, klik tombol luapan dan item muncul di jendela pop-up di bawah toolbar. Gambar berikut menunjukkan toolbar dengan elemen melimpah.

Cuplikan layar toolbar horizontal di WPF dengan item luapan ditampilkan.

Kontrol penempatan item pada toolbar di panel luapan dengan mengatur properti terlampir ToolBar.OverflowMode ke OverflowMode.Always, OverflowMode.Never, atau OverflowMode.AsNeeded. Contoh berikut menetapkan bahwa empat tombol terakhir pada toolbar harus selalu berada di panel 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>

Menggunakan ToolBar dengan ToolBarPanel dan ToolBarOverflowPanel dalam ControlTemplate. Menangani tata letak item pada ToolBarPanel bilah alat. ToolBarOverflowPanel mengatur tata letak item yang tidak muat di toolbar.

Gaya dan templat

Anda dapat memodifikasi default ControlTemplate untuk memberi kontrol tampilan yang unik. Untuk informasi selengkapnya, lihat Apa itu gaya dan templat? dan Cara membuat templat untuk kontrol.

Properti konten

Kontrol ToolBar menggunakan Items properti sebagai properti kontennya. Properti ini memungkinkan penambahan subitem ke bilah alat, yang biasanya merupakan tombol atau kontrol lain untuk memanggil perintah.

Bagian

Tabel berikut mencantumkan bagian-bagian yang diberi nama dari kontrol ToolBar.

Bagian Tipe Description
PART_ToolBarOverflowPanel ToolBarOverflowPanel Objek yang berisi kontrol yang berada di area luapan bilah alat.
PART_ToolBarPanel ToolBarPanel Objek yang berisi kontrol pada bilah alat.

Saat Anda membuat ControlTemplate untuk ToolBar, templat Anda mungkin berisi ItemsPresenter dalam ScrollViewer. ItemsPresenter menampilkan setiap item di toolbar, dan ScrollViewer mengaktifkan pengguliran dalam kontrol tersebut. ItemsPresenter Jika bukan anak langsung dari ScrollViewer, Anda harus memberikan ItemsPresenter nama ItemsPresenter.

Keadaan visual

Kontrol ini tidak menentukan status visual apa pun.

Lihat juga

  • Last updated on