Kontrol Bilah Alat dan Gaya Tombol
Gaya jendela berikut ini khusus untuk toolbar. Mereka dikombinasikan dengan gaya jendela lain saat toolbar dibuat.
Catatan Untuk Common Controls versi 6.00, jika gaya visual digunakan dengan toolbar, tombol selalu transparan terlepas dari pengaturan gaya. Jika tidak, perilaku transparansi normal seperti yang ditunjukkan oleh penggunaan gaya TBSTYLE_FLAT atau TBSTYLE_TRANSPARENT.
Catatan
Comctl32.dll versi 6 tidak dapat didistribusikan ulang tetapi disertakan dalam Windows. Untuk menggunakan Comctl32.dll versi 6, tentukan dalam manifes. Untuk informasi selengkapnya tentang manifes, lihat Mengaktifkan Gaya Visual.
| Terus-menerus | Deskripsi |
|---|---|
|
Memungkinkan pengguna mengubah posisi tombol toolbar dengan menyeretnya sambil menahan tombol ALT. Jika gaya ini tidak ditentukan, pengguna harus menahan tombol SHIFT sambil menyeret tombol. Perhatikan bahwa gaya CCS_ADJUSTABLE harus ditentukan untuk mengaktifkan tombol bilah alat untuk diseret. |
|
Versi 4.70. Menghasilkan kode pemberitahuan NM_CUSTOMDRAW saat toolbar memproses pesan WM_ERASEBKGND . |
|
Versi 4.70. Membuat bilah alat datar. Di toolbar datar, toolbar dan tombol transparan dan pelacakan panas diaktifkan. Teks tombol muncul di bawah bitmap tombol. Untuk mencegah masalah pengecatan ulang, gaya ini harus diatur sebelum kontrol bilah alat terlihat. |
|
Versi 4.70. Membuat toolbar datar dengan teks tombol di sebelah kanan bitmap. Jika tidak, gaya ini identik dengan TBSTYLE_FLAT. Untuk mencegah masalah pengecatan ulang, gaya ini harus diatur sebelum kontrol bilah alat terlihat. |
|
Versi 4.71. Menghasilkan kode pemberitahuan TBN_GETOBJECT untuk meminta jatuhkan objek target saat kursor melewati tombol toolbar. |
|
Membuat kontrol tipsalat yang dapat digunakan aplikasi untuk menampilkan teks deskriptif untuk tombol di toolbar. |
|
Versi 4.71. Membuat bilah alat transparan. Di toolbar transparan, toolbar transparan tetapi tombolnya tidak. Teks tombol muncul di bawah bitmap tombol. Untuk mencegah masalah pengecatan ulang, gaya ini harus diatur sebelum kontrol bilah alat terlihat. |
|
Membuat bilah alat yang bisa memiliki beberapa baris tombol. Tombol toolbar dapat "membungkus" ke baris berikutnya ketika toolbar menjadi terlalu sempit untuk menyertakan semua tombol pada baris yang sama. Ketika toolbar dibungkus, pemisah akan terjadi pada pemisah paling kanan atau tombol paling kanan jika tidak ada pemisah pada bilah. Gaya ini harus diatur untuk menampilkan kontrol bilah alat vertikal ketika bilah alat adalah bagian dari kontrol bilah-ulang vertikal. Gaya ini tidak dapat digabungkan dengan CCS_VERT. |
Catatan: Tombol toolbar dapat memiliki kombinasi gaya berikut. Untuk menentukan gaya tombol, atur bendera yang sesuai di anggota fsStyle struktur TBBUTTON tombol. Tidak semua gaya dapat digabungkan.
Untuk Shell versi 4.72 dan yang lebih lama, bendera gaya jendela dan tombol memiliki formulir TBSTYLE_XXX. Jika Anda mengkompilasi aplikasi dengan versi 4.72 atau yang lebih lama dari Commctrl.h, Anda harus menggunakan bendera gaya tombol TBSTYLE_XXX. Untuk versi 5.80 dan yang lebih baru, semua gaya tombol memiliki formulir BTNS_XXX. Semua nilai TBSTYLE_XXX memiliki nilai BTNS_XXX yang setara, dengan arti dan nilai numerik yang sama. Untuk kenyamanan, kedua formulir diberikan dalam tabel berikut.
| Terus-menerus | Deskripsi |
|---|---|
|
Versi 5.80. Menentukan bahwa kontrol bilah alat tidak boleh menetapkan lebar standar ke tombol. Sebaliknya, lebar tombol akan dihitung berdasarkan lebar teks ditambah gambar tombol. Gunakan bendera gaya yang setara, TBSTYLE_AUTOSIZE, untuk versi 4.72 dan yang lebih lama. |
|
Versi 5.80. Membuat tombol standar. Gunakan bendera gaya yang setara, TBSTYLE_BUTTON, untuk versi 4.72 dan yang lebih lama. Bendera ini didefinisikan sebagai 0, dan harus digunakan untuk menandakan bahwa tidak ada bendera lain yang ditetapkan. |
|
Versi 5.80. Membuat tombol dorong dual-state yang beralih antara status yang ditekan dan tidak tertekan setiap kali pengguna mengkliknya. Tombol ini memiliki warna latar belakang yang berbeda ketika berada dalam status ditekan. Gunakan bendera gaya yang setara, TBSTYLE_CHECK, untuk versi 4.72 dan yang lebih lama. |
|
Versi 5.80. Membuat tombol yang tetap ditekan hingga tombol lain dalam grup ditekan, mirip dengan tombol opsi (juga dikenal sebagai tombol radio). Ini setara dengan menggabungkan BTNS_CHECK dan BTNS_GROUP. Gunakan bendera gaya yang setara, TBSTYLE_CHECKGROUP, untuk versi 4.72 dan yang lebih lama. |
|
Versi 5.80. Membuat tombol gaya drop-down yang dapat menampilkan daftar saat tombol diklik. Alih-alih pesan WM_COMMAND digunakan untuk tombol normal, tombol drop-down mengirim kode pemberitahuan TBN_DROPDOWN . Aplikasi kemudian dapat meminta penangan pemberitahuan menampilkan daftar opsi. Gunakan bendera gaya yang setara, TBSTYLE_DROPDOWN, untuk versi 4.72 dan yang lebih lama. Jika toolbar memiliki gaya TBSTYLE_EX_DRAWDDARROWS diperluas, tombol drop-down akan memiliki panah turun bawah yang ditampilkan di bagian terpisah di sebelah kanannya. Jika panah diklik, kode pemberitahuan TBN_DROPDOWN akan dikirim. Jika tombol terkait diklik, pesan WM_COMMAND akan dikirim. |
|
Versi 5.80. Saat dikombinasikan dengan BTNS_CHECK, buat tombol yang tetap ditekan hingga tombol lain dalam grup ditekan. Gunakan bendera gaya yang setara, TBSTYLE_GROUP, untuk versi 4.72 dan yang lebih lama. |
|
Versi 5.80. Menentukan bahwa teks tombol tidak akan memiliki awalan akselerator yang terkait dengannya. Gunakan bendera gaya yang setara, TBSTYLE_NOPREFIX, untuk versi 4.72 dan yang lebih lama. |
|
Versi 5.80. Membuat pemisah, memberikan celah kecil di antara grup tombol. Tombol yang memiliki gaya ini tidak menerima input pengguna. Gunakan bendera gaya yang setara, TBSTYLE_SEP, untuk versi 4.72 dan yang lebih lama. |
|
Versi 5.81. Menentukan bahwa teks tombol harus ditampilkan. Semua tombol dapat memiliki teks, tetapi hanya tombol dengan gaya tombol BTNS_SHOWTEXT yang akan menampilkannya. Gaya tombol ini harus digunakan dengan gaya TBSTYLE_LIST dan gaya TBSTYLE_EX_MIXEDBUTTONS diperluas. Jika Anda mengatur teks untuk tombol yang tidak memiliki gaya BTNS_SHOWTEXT, kontrol toolbar akan secara otomatis menampilkannya sebagai tipsalat saat kursor mengarahkan kursor ke atas tombol. Fitur ini memungkinkan aplikasi Anda menghindari penanganan kode pemberitahuan TBN_GETINFOTIP atau TTN_GETDISPINFO untuk toolbar. |
|
Versi 5.80. Menentukan bahwa tombol akan memiliki panah drop-down, tetapi tidak sebagai bagian terpisah. Tombol dengan gaya ini berperilaku sama, terlepas dari apakah gaya TBSTYLE_EX_DRAWDDARROWS diperluas diatur. |
|
Setara dengan BTNS_AUTOSIZE. Gunakan TBSTYLE_AUTOSIZE untuk versi 4.72 dan yang lebih lama. |
|
Setara dengan BTNS_BUTTON. Gunakan TBSTYLE_BUTTON untuk versi 4.72 dan yang lebih lama. |
|
Setara dengan BTNS_CHECK. Gunakan TBSTYLE_CHECK untuk versi 4.72 dan yang lebih lama. |
|
Setara dengan BTNS_CHECKGROUP. Gunakan TBSTYLE_CHECKGROUP untuk versi 4.72 dan yang lebih lama. |
|
Setara dengan BTNS_DROPDOWN. Gunakan TBSTYLE_DROPDOWN untuk versi 4.72 dan yang lebih lama. |
|
Setara dengan BTNS_GROUP. Gunakan TBSTYLE_GROUP untuk versi 4.72 dan yang lebih lama. |
|
Setara dengan BTNS_NOPREFIX. Gunakan TBSTYLE_NOPREFIX untuk versi 4.72 dan yang lebih lama. |
|
Setara dengan BTNS_SEP. Gunakan TBSTYLE_SEP untuk versi 4.72 dan yang lebih lama. |
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header |
|
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk