Bilah alat
Bagian ini berisi informasi tentang elemen pemrograman yang digunakan dengan kontrol toolbar.
Ikhtisar
| Topik | Isi |
|---|---|
| Tentang Kontrol Toolbar | Bilah alat adalah kontrol yang berisi satu atau beberapa tombol. Setiap tombol, saat diklik oleh pengguna, mengirim pesan perintah ke jendela induk. Biasanya, tombol di toolbar sesuai dengan item di menu aplikasi, menyediakan cara tambahan dan lebih langsung bagi pengguna untuk mengakses perintah aplikasi. |
| Menggunakan Kontrol Bilah Alat | Topik ini berisi detail implementasi dan contoh kode untuk menggunakan kontrol toolbar di aplikasi Anda. |
Fungsi
| Topik | Isi |
|---|---|
| CreateMappedBitmap | Membuat bitmap untuk digunakan dalam bilah alat. |
| CreateToolbarEx | Membuat jendela bilah alat dan menambahkan tombol yang ditentukan ke bilah alat.
Catatan: Fungsi ini tidak digunakan lagi, karena tidak mendukung semua fitur toolbar. GunakanCreateWindowEx sebagai gantinya. Misalnya, lihat Menggunakan Kontrol Toolbar. |
Pesan
| Topik | Isi |
|---|---|
| TB_ADDBITMAP | Menambahkan satu atau beberapa gambar ke daftar gambar tombol yang tersedia untuk toolbar. |
| TB_ADDBUTTONS | Menambahkan satu atau beberapa tombol ke bilah alat. |
| TB_ADDSTRING | Menambahkan string baru ke kumpulan string toolbar. |
| TB_AUTOSIZE | Menyebabkan bilah alat diubah ukurannya. |
| TB_BUTTONCOUNT | Mengambil hitungan tombol yang saat ini ada di toolbar. |
| TB_BUTTONSTRUCTSIZE | Menentukan ukuran strukturTBBUTTON. |
| TB_CHANGEBITMAP | Mengubah bitmap untuk tombol di toolbar. |
| TB_CHECKBUTTON | Memeriksa atau menghapus centang tombol yang diberikan di toolbar. |
| TB_COMMANDTOINDEX | Mengambil indeks berbasis nol untuk tombol yang terkait dengan pengidentifikasi perintah yang ditentukan. |
| TB_CUSTOMIZE | Menampilkan kotak dialog Bilah Alat Kustomisasi. |
| TB_DELETEBUTTON | Menghapus tombol dari bilah alat. |
| TB_ENABLEBUTTON | Mengaktifkan atau menonaktifkan tombol yang ditentukan di toolbar. |
| TB_GETANCHORHIGHLIGHT | Mengambil pengaturan sorotan jangkar untuk bilah alat. |
| TB_GETBITMAP | Mengambil indeks bitmap yang terkait dengan tombol di toolbar. |
| TB_GETBITMAPFLAGS | Mengambil bendera yang menjelaskan jenis bitmap yang akan digunakan. |
| TB_GETBUTTON | Mengambil informasi tentang tombol yang ditentukan dalam bilah alat. |
| TB_GETBUTTONINFO | Mengambil informasi yang diperluas untuk tombol di toolbar. |
| TB_GETBUTTONSIZE | Mengambil lebar saat ini dan tinggi tombol bilah alat, dalam piksel. |
| TB_GETBUTTONTEXT | Mengambil teks tampilan tombol pada bilah alat. |
| TB_GETCOLORSCHEME | Mengambil informasi skema warna dari kontrol bilah alat. |
| TB_GETDISABLEDIMAGELIST | Mengambil daftar gambar yang digunakan kontrol toolbar untuk menampilkan tombol yang tidak aktif. |
| TB_GETEXTENDEDSTYLE | Mengambil gaya yang diperluas untuk kontrol bilah alat. |
| TB_GETHOTIMAGELIST | Mengambil daftar gambar yang digunakan kontrol bilah alat untuk menampilkan tombol panas. |
| TB_GETHOTITEM | Mengambil indeks item panas di toolbar. |
| TB_GETIDEALSIZE | Mendapatkan ukuran bilah alat yang ideal. |
| TB_GETIMAGELIST | Mengambil daftar gambar yang digunakan kontrol toolbar untuk menampilkan tombol dalam status defaultnya. Kontrol bilah alat menggunakan daftar gambar ini untuk menampilkan tombol ketika tidak panas atau dinonaktifkan. |
| TB_GETIMAGELISTCOUNT | Mendapatkan jumlah daftar gambar yang terkait dengan toolbar. |
| TB_GETINSERTMARK | Mengambil tanda penyisipan saat ini untuk bilah alat. |
| TB_GETINSERTMARKCOLOR | Mengambil warna yang digunakan untuk menggambar tanda penyisipan untuk bilah alat. |
| TB_GETITEMDROPDOWNRECT | Mendapatkan persegi panjang pembatas jendela dropdown untuk item toolbar dengan gaya BTNS_DROPDOWN. |
| TB_GETITEMRECT | Mengambil persegi panjang pembatas tombol di toolbar. |
| TB_GETMAXSIZE | Mengambil ukuran total semua tombol dan pemisah yang terlihat di toolbar. |
| TB_GETMETRICS | Mengambil metrik kontrol toolbar. |
| TB_GETOBJECT | MengambilIDropTargetuntuk kontrol toolbar. |
| TB_GETPADDING | Mengambil padding untuk kontrol bilah alat. |
| TB_GETPRESSEDIMAGELIST | Mendapatkan daftar gambar yang digunakan kontrol toolbar untuk menampilkan tombol dalam keadaan ditekan. |
| TB_GETRECT | Mengambil persegi panjang pembatas untuk tombol toolbar tertentu. |
| TB_GETROWS | Mengambil jumlah baris tombol di toolbar dengan gaya TBSTYLE_WRAPABLE. |
| TB_GETSTATE | Mengambil informasi tentang status tombol yang ditentukan di toolbar, seperti apakah tombol diaktifkan, ditekan, atau dicentang. |
| TB_GETSTRING | Mengambil string dari kumpulan string toolbar. |
| TB_GETSTYLE | Mengambil gaya yang saat ini digunakan untuk kontrol bilah alat. |
| TB_GETTEXTROWS | Mengambil jumlah maksimum baris teks yang dapat ditampilkan pada tombol toolbar. |
| TB_GETTOOLTIPS | Mengambil handel ke kontrol tipsalat, jika ada, yang terkait dengan toolbar. |
| TB_GETUNICODEFORMAT | Mengambil bendera format karakter Unicode untuk kontrol. |
| TB_HASACCELERATOR |
Dimaksudkan untuk penggunaan internal; tidak disarankan untuk digunakan dalam aplikasi. Mengambil hitungan tombol toolbar yang memiliki karakter akselerator yang ditentukan. |
| TB_HIDEBUTTON | Menyembunyikan atau memperlihatkan tombol yang ditentukan dalam bilah alat. |
| TB_HITTEST | Menentukan di mana titik berada dalam kontrol toolbar. |
| TB_INDETERMINATE | Mengatur atau menghapus status tombol yang ditentukan dalam toolbar yang tidak ditentukan. |
| TB_INSERTBUTTON | Sisipkan tombol di bilah alat. |
| TB_INSERTMARKHITTEST | Mengambil informasi tanda penyisipan untuk titik di toolbar. |
| TB_ISBUTTONCHECKED | Menentukan apakah tombol yang ditentukan dalam bilah alat dicentang. |
| TB_ISBUTTONENABLED | Menentukan apakah tombol yang ditentukan dalam bilah alat diaktifkan. |
| TB_ISBUTTONHIDDEN | Menentukan apakah tombol yang ditentukan di toolbar disembunyikan. |
| TB_ISBUTTONHIGHLIGHTED | Memeriksa status sorotan tombol bilah alat. |
| TB_ISBUTTONINDETERMINATE | Menentukan apakah tombol yang ditentukan di toolbar tidak ditentukan. |
| TB_ISBUTTONPRESSED | Menentukan apakah tombol yang ditentukan dalam bilah alat ditekan. |
| TB_LOADIMAGES | Memuat gambar tombol yang ditentukan sistem ke dalam daftar gambar kontrol toolbar. |
| TB_MAPACCELERATOR | Menentukan ID tombol yang sesuai dengan karakter akselerator yang ditentukan. |
| TB_MARKBUTTON | Mengatur status sorotan tombol yang diberikan dalam kontrol toolbar. |
| TB_MOVEBUTTON | Memindahkan tombol dari satu indeks ke indeks lainnya. |
| TB_PRESSBUTTON | Menekan atau melepaskan tombol yang ditentukan di toolbar. |
| TB_REPLACEBITMAP | Mengganti bitmap yang ada dengan bitmap baru. |
| TB_SAVERESTORE | Kirim pesan ini untuk memulai penyimpanan atau pemulihan status bilah alat. |
| TB_SETANCHORHIGHLIGHT | Mengatur pengaturan sorotan jangkar untuk bilah alat. |
| TB_SETBITMAPSIZE | Mengatur ukuran gambar bitmapped yang akan ditambahkan ke toolbar. |
| TB_SETBOUNDINGSIZE |
Dimaksudkan untuk penggunaan internal; tidak disarankan untuk digunakan dalam aplikasi. Mengatur ukuran pembatas untuk kontrol toolbar multi-kolom. |
| TB_SETBUTTONINFO | Menyetel informasi untuk tombol yang ada di bilah alat. |
| TB_SETBUTTONSIZE | Mengatur ukuran tombol pada bilah alat. |
| TB_SETBUTTONWIDTH | Mengatur lebar tombol minimum dan maksimum dalam kontrol bilah alat. |
| TB_SETCMDID | Mengatur pengidentifikasi perintah tombol toolbar. |
| TB_SETCOLORSCHEME | Menyetel informasi skema warna untuk kontrol bilah alat. |
| TB_SETDISABLEDIMAGELIST | Mengatur daftar gambar yang akan digunakan kontrol bilah alat untuk menampilkan tombol yang dinonaktifkan. |
| TB_SETDRAWTEXTFLAGS | Mengatur bendera gambar teks untuk toolbar. |
| TB_SETEXTENDEDSTYLE | Mengatur gaya yang diperluas untuk kontrol bilah alat. |
| TB_SETHOTIMAGELIST | Mengatur daftar gambar yang akan digunakan kontrol bilah alat untuk menampilkan tombol panas. |
| TB_SETHOTITEM | Mengatur item panas di bilah alat. |
| TB_SETHOTITEM2 | Mengatur item panas di bilah alat. |
| TB_SETIMAGELIST | Mengatur daftar gambar yang digunakan toolbar untuk menampilkan tombol yang berada dalam status defaultnya. |
| TB_SETINDENT | Mengatur indentasi untuk tombol pertama dalam kontrol toolbar. |
| TB_SETINSERTMARK | Menyetel tanda penyisipan saat ini untuk bilah alat. |
| TB_SETINSERTMARKCOLOR | Mengatur warna yang digunakan untuk menggambar tanda penyisipan untuk bilah alat. |
| TB_SETLISTGAP | Mengatur jarak antara tombol toolbar pada toolbar tertentu. |
| TB_SETMAXTEXTROWS | Mengatur jumlah maksimum baris teks yang ditampilkan pada tombol toolbar. |
| TB_SETMETRICS | Mengatur metrik kontrol toolbar. |
| TB_SETPADDING | Mengatur padding untuk kontrol bilah alat. |
| TB_SETPARENT | Mengatur jendela tempat kontrol bilah alat mengirim kode pemberitahuan. |
| TB_SETPRESSEDIMAGELIST | Mengatur daftar gambar yang digunakan toolbar untuk menampilkan tombol yang dalam keadaan ditekan. |
| TB_SETROWS | Mengatur jumlah baris tombol dalam toolbar. |
| TB_SETSTATE | Mengatur status untuk tombol yang ditentukan dalam bilah alat. |
| TB_SETSTYLE | Mengatur gaya untuk kontrol bilah alat. |
| TB_SETTOOLTIPS | Mengaitkan kontrol tipsalat dengan toolbar. |
| TB_SETUNICODEFORMAT | Mengatur bendera format karakter Unicode untuk kontrol. Pesan ini memungkinkan Anda mengubah kumpulan karakter yang digunakan oleh kontrol pada waktu proses daripada harus membuat ulang kontrol. |
| TB_SETWINDOWTHEME | Mengatur gaya visual kontrol bilah alat. |
| TB_TRANSLATEACCELERATOR | Meneruskan pesan keyboard ke toolbar. |
Pemberitahuan
| Topik | Isi |
|---|---|
| NM_CHAR (toolbar) | Dikirim oleh toolbar saat menerima pesan WM_CHAR. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| NM_CLICK (toolbar) | Dikirim oleh kontrol toolbar ketika pengguna mengklik item dengan tombol mouse kiri. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| NM_CUSTOMDRAW (toolbar) | Dikirim oleh toolbar untuk memberi tahu jendela induknya tentang operasi menggambar. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| NM_DBLCLK (toolbar) | Memberi tahu jendela induk kontrol bilah alat bahwa pengguna telah mengklik dua kali tombol mouse kiri dalam kontrol. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| NM_KEYDOWN (toolbar) | Dikirim oleh kontrol saat kontrol memiliki fokus keyboard dan pengguna menekan tombol. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| NM_LDOWN | Memberi tahu jendela induk bilah alat bahwa tombol mouse kiri telah ditekan. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| NM_RCLICK (toolbar) | Dikirim oleh kontrol toolbar ketika pengguna mengklik toolbar dengan tombol kanan mouse. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| NM_RDBLCLK (toolbar) | Memberi tahu jendela induk kontrol bahwa pengguna telah mengklik dua kali tombol kanan mouse dalam kontrol. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| NM_RELEASEDCAPTURE (toolbar) | Memberi tahu jendela induk kontrol toolbar bahwa kontrol melepaskan pengambilan mouse. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| NM_TOOLTIPSCREATED (toolbar) | Memberi tahu jendela induk bilah alat bahwa toolbar telah membuat kontrol tipsalat. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| TBN_BEGINADJUST | Memberi tahu jendela induk toolbar bahwa pengguna telah mulai menyesuaikan toolbar. Kode pesan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| TBN_BEGINDRAG | Memberi tahu jendela induk toolbar bahwa pengguna telah mulai menyeret tombol di toolbar. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| TBN_CUSTHELP | Memberi tahu jendela induk toolbar bahwa pengguna telah memilih tombol Bantuan dalam kotak dialog Kustomisasi Bilah Alat. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| TBN_DELETINGBUTTON | Dikirim oleh kontrol toolbar ketika tombol akan dihapus. |
| TBN_DRAGOUT | Dikirim oleh kontrol toolbar saat pengguna mengklik tombol lalu memindahkan kursor dari tombol. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| TBN_DRAGOVER | Memastikan apakah pesan TB_MARKBUTTON harus dikirim untuk tombol yang sedang diseret. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| TBN_DROPDOWN | Dikirim oleh kontrol toolbar saat pengguna mengklik tombol dropdown. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| TBN_DUPACCELERATOR | Memastikan apakah kunci akselerator dapat digunakan pada dua bilah alat aktif atau lebih. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| TBN_ENDADJUST | Memberi tahu jendela induk toolbar bahwa pengguna telah berhenti menyesuaikan bilah alat. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| TBN_ENDDRAG | Memberi tahu jendela induk bilah alat bahwa pengguna telah berhenti menyeret tombol di toolbar. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| TBN_GETBUTTONINFO | Mengambil informasi kustomisasi bilah alat dan memberi tahu jendela induk toolbar tentang perubahan apa pun yang dilakukan pada toolbar. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| TBN_GETDISPINFO | Mengambil informasi tampilan untuk item bilah alat. Pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| TBN_GETINFOTIP | Mengambil informasi infotip untuk item bilah alat. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| TBN_GETOBJECT | Dikirim oleh kontrol toolbar yang menggunakan gaya TBSTYLE_REGISTERDROP untuk meminta objek target drop saat penunjuk melewati salah satu tombolnya. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| TBN_HOTITEMCHANGE | Dikirim oleh kontrol toolbar ketika item panas (disorot) berubah. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| TBN_INITCUSTOMIZE | Memberi tahu jendela induk bilah alat yang menyesuaikan telah dimulai. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| TBN_MAPACCELERATOR | Meminta indeks tombol di toolbar yang sesuai dengan karakter akselerator yang ditentukan. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| TBN_QUERYDELETE | Memberi tahu jendela induk toolbar apakah tombol dapat dihapus dari toolbar saat pengguna menyesuaikan toolbar. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| TBN_QUERYINSERT | Memberi tahu jendela induk toolbar apakah tombol dapat disisipkan di sebelah kiri tombol yang ditentukan saat pengguna menyesuaikan bilah alat. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| TBN_RESET | Memberi tahu jendela induk toolbar bahwa pengguna telah mereset konten kotak dialog Kustomisasi Bilah Alat. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| TBN_RESTORE | Memberi tahu jendela induk toolbar bahwa toolbar sedang dalam proses pemulihan. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| TBN_SAVE | Memberi tahu jendela induk toolbar bahwa toolbar sedang dalam proses disimpan. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| TBN_TOOLBARCHANGE | Memberi tahu jendela induk bilah alat bahwa pengguna telah menyesuaikan bilah alat. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| TBN_WRAPACCELERATOR | Meminta indeks tombol dalam satu atau beberapa toolbar yang sesuai dengan karakter akselerator yang ditentukan. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
| TBN_WRAPHOTITEM | Memberi tahu aplikasi dengan dua bilah alat atau lebih bahwa item panas akan berubah. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY. |
Struktur
| Topik | Isi |
|---|---|
| COLORMAP | Berisi informasi yang digunakan oleh fungsiCreateMappedBitmap untuk memetakan warna bitmap. |
| NMTBCUSTOMDRAW | Berisi informasi khusus untuk kode pemberitahuan NM_CUSTOMDRAW yang dikirim oleh kontrol bilah alat. |
| NMTBDISPINFO | Berisi dan menerima informasi tampilan untuk item bilah alat. Struktur ini digunakan dengan kode pemberitahuan TBN_GETDISPINFO. |
| NMTBGETINFOTIP | Berisi dan menerima informasi infotip untuk item bilah alat. Struktur ini digunakan dengan kode pemberitahuan TBN_GETINFOTIP. |
| NMTBHOTITEM | Berisi informasi yang digunakan dengan kode pemberitahuan TBN_HOTITEMCHANGE. |
| NMTBRESTORE | Memungkinkan aplikasi untuk mengekstrak informasi yang ditempatkan di NMTBSAVE ketika status toolbar disimpan. Struktur ini diteruskan ke aplikasi ketika mereka menerima kode pemberitahuan TBN_RESTORE. |
| NMTBSAVE | Struktur ini diteruskan ke aplikasi ketika mereka menerima kode pemberitahuan TBN_SAVE. Ini berisi informasi tentang tombol yang saat ini sedang disimpan. Aplikasi dapat mengubah nilai anggota untuk menyimpan informasi tambahan. |
| NMTOOLBAR | Berisi informasi yang digunakan untuk memproses kode pemberitahuan bilah alat. Struktur ini menggantikan struktur TBNOTIFY. |
| TBADDBITMAP | Menambahkan bitmap yang berisi gambar tombol ke bilah alat. |
| TBBUTTON | Berisi informasi tentang tombol di bilah alat. |
| TBBUTTONINFO | Berisi atau menerima informasi untuk tombol tertentu di bilah alat. |
| TBINSERTMARK | Berisi informasi tentang tanda penyisipan dalam kontrol bilah alat. |
| TBMETRICS | Menentukan metrik bilah alat yang digunakan untuk menyusutkan atau memperluas item bilah alat. |
| TBREPLACEBITMAP | Digunakan dengan pesan TB_REPLACEBITMAP untuk mengganti satu bitmap toolbar dengan bitmap lainnya. |
| TBSAVEPARAMS | Menentukan lokasi dalam registri tempat pesan TB_SAVERESTORE menyimpan dan mengambil informasi tentang status toolbar. |
Konstanta
| Topik | Isi |
|---|---|
| Status Tombol Bilah Alat | Bagian ini mencantumkan status yang bisa dimiliki tombol bilah alat. |
| Kontrol Toolbar dan Gaya Tombol | Gaya jendela berikut ini khusus untuk bilah alat. Mereka dikombinasikan dengan gaya jendela lain saat toolbar dibuat. Catatan Untuk Kontrol Umum 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 atau yang lebih baru. Untuk menggunakan Comctl32.dll versi 6, tentukan dalam manifes. Untuk informasi selengkapnya tentang manifes, lihat Mengaktifkan Gaya Visual. |
| Gaya Toolbar Diperluas | Bagian ini mencantumkan gaya yang diperluas yang didukung oleh kontrol toolbar. |
| Nilai Indeks Gambar Tombol Standar Bilah Alat | Bagian ini menentukan nilai indeks gambar dalam bitmap standar. |