Tombol (Kontrol Windows)
Bagian ini berisi informasi tentang elemen pemrograman yang digunakan dengan kontrol tombol. Tombol adalah kontrol yang dapat diklik pengguna untuk memberikan input ke aplikasi.
Gambaran Umum
| Topik | Konten |
|---|---|
| Pesan Tombol | Topik ini membahas pesan yang digunakan dengan tombol. |
| Status Tombol | Bagian ini membahas cara memilih tombol mengubah statusnya dan bagaimana aplikasi harus merespons. |
| Tipe Tombol | Topik ini membahas berbagai jenis tombol. |
| Menggunakan Tombol | Bagian ini menjelaskan cara melakukan tugas tertentu yang terkait dengan tombol. |
Fungsi
| Topik | Konten |
|---|---|
| CheckDlgButton | Mengubah status pemeriksaan kontrol tombol. |
| CheckRadioButton | Menambahkan tanda centang ke (memeriksa) tombol radio tertentu dalam grup dan menghapus tanda centang dari (menghapus) semua tombol radio lainnya dalam grup. |
| IsDlgButtonChecked | Fungsi IsDlgButtonChecked menentukan apakah kontrol tombol dicentang atau apakah kontrol tombol tiga status dicentang, tidak dicentang, atau tidak ditentukan. |
Makro
| Topik | Konten |
|---|---|
| Button_Enable | Mengaktifkan atau menonaktifkan tombol. |
| Button_GetCheck | Mendapatkan status centang tombol radio atau kotak centang. Anda dapat menggunakan makro ini atau mengirim pesan BM_GETCHECK secara eksplisit. |
| Button_GetIdealSize | Mendapatkan ukuran tombol yang paling sesuai dengan teks dan gambar, jika ada daftar gambar. Anda dapat menggunakan makro ini atau mengirim pesan BCM_GETIDEALSIZE secara eksplisit. |
| Button_GetImageList | Mendapatkan struktur BUTTON_IMAGELIST yang menjelaskan daftar gambar yang diatur untuk kontrol tombol. Anda dapat menggunakan makro ini atau mengirim pesan BCM_GETIMAGELIST secara eksplisit. |
| Button_GetNote | Mendapatkan teks catatan yang terkait dengan tombol tautan perintah. Anda dapat menggunakan makro ini atau mengirim pesan BCM_GETNOTE secara eksplisit. |
| Button_GetNoteLength | Mendapatkan panjang teks catatan yang mungkin ditampilkan dalam deskripsi untuk tautan perintah. Gunakan makro ini atau kirim pesan BCM_GETNOTELENGTH secara eksplisit. |
| Button_GetSplitInfo | Mendapatkan informasi untuk kontrol tombol terpisah tertentu. Gunakan makro ini atau kirim pesan BCM_GETSPLITINFO secara eksplisit. |
| Button_GetState | Mendapatkan status centang tombol radio atau kotak centang. Anda dapat menggunakan makro ini atau mengirim pesan BM_GETSTATE secara eksplisit. |
| Button_GetText | Mendapatkan teks tombol. |
| Button_GetTextLength | Mendapatkan jumlah karakter dalam teks tombol. |
| Button_GetTextMargin | Mendapatkan margin yang digunakan untuk menggambar teks dalam kontrol tombol. Anda dapat menggunakan makro ini atau mengirim pesan BCM_GETTEXTMARGIN secara eksplisit. |
| Button_SetCheck | Mengatur status centang tombol radio atau kotak centang. Anda dapat menggunakan makro ini atau mengirim pesan BM_SETCHECK secara eksplisit. |
| Button_SetDropDownState | Mengatur status drop-down untuk tombol tertentu dengan gaya BS_SPLITBUTTON. Gunakan makro ini atau kirim pesan BCM_SETDROPDOWNSTATE secara eksplisit. |
| Button_SetElevationRequiredState | Mengatur status elevasi yang diperlukan untuk tombol atau tautan perintah tertentu untuk menampilkan ikon yang ditingkatkan. Gunakan makro ini atau kirim pesan BCM_SETSHIELD secara eksplisit. |
| Button_SetImageList | Menetapkan daftar gambar ke kontrol tombol. Anda dapat menggunakan makro ini atau mengirim pesan BCM_SETIMAGELIST secara eksplisit. |
| Button_SetNote | Mengatur teks catatan yang terkait dengan tombol tautan perintah tertentu. Anda dapat menggunakan makro ini atau mengirim pesan BCM_SETNOTE secara eksplisit. |
| Button_SetSplitInfo | Mengatur informasi untuk kontrol tombol terpisah tertentu. Gunakan makro ini atau kirim pesan BCM_SETSPLITINFO secara eksplisit. |
| Button_SetState | Mengatur status sorotan tombol. Status sorotan menunjukkan apakah tombol disorot seolah-olah pengguna telah mendorongnya. Anda dapat menggunakan makro ini atau mengirim pesan BM_SETSTATE secara eksplisit. |
| Button_SetStyle | Mengatur gaya tombol. Anda dapat menggunakan makro ini atau mengirim pesan BM_SETSTYLE secara eksplisit. |
| Button_SetText | Mengatur teks tombol. |
| Button_SetTextMargin | Mengatur margin untuk menggambar teks dalam kontrol tombol. Anda dapat menggunakan makro ini atau mengirim pesan BCM_SETTEXTMARGIN secara eksplisit. |
Pesan
| Topik | Konten |
|---|---|
| BCM_GETIDEALSIZE | Mendapatkan ukuran tombol yang paling sesuai dengan teks dan gambarnya, jika ada daftar gambar. Anda dapat mengirim pesan ini secara eksplisit atau menggunakan makro Button_GetIdealSize. |
| BCM_GETIMAGELIST | Mendapatkan struktur BUTTON_IMAGELIST yang menjelaskan daftar gambar yang ditetapkan ke kontrol tombol. Anda dapat mengirim pesan ini secara eksplisit atau menggunakan makro Button_GetImageList. |
| BCM_GETNOTE | Mendapatkan teks catatan yang terkait dengan tombol tautan perintah. Anda dapat mengirim pesan ini secara eksplisit atau menggunakan makro Button_GetNote. |
| BCM_GETNOTELENGTH | Mendapatkan panjang teks catatan yang mungkin ditampilkan dalam deskripsi untuk tombol tautan perintah. Kirim pesan ini secara eksplisit atau dengan menggunakan makro Button_GetNoteLength. |
| BCM_GETSPLITINFO | Mendapatkan informasi untuk kontrol tombol terpisah. Kirim pesan ini secara eksplisit atau dengan menggunakan makro Button_GetSplitInfo. |
| BCM_GETTEXTMARGIN | Mendapatkan margin yang digunakan untuk menggambar teks dalam kontrol tombol. Anda dapat mengirim pesan ini secara eksplisit atau menggunakan makro Button_GetTextMargin. |
| BCM_SETDROPDOWNSTATE | Mengatur status drop-down untuk tombol dengan gaya TBSTYLE_DROPDOWN. Kirim pesan ini secara eksplisit atau dengan menggunakan makro Button_SetDropDownState. |
| BCM_SETIMAGELIST | Menetapkan daftar gambar ke kontrol tombol. Anda dapat mengirim pesan ini secara eksplisit atau menggunakan makro Button_SetImageList. |
| BCM_SETNOTE | Mengatur teks catatan yang terkait dengan tombol tautan perintah. Anda dapat mengirim pesan ini secara eksplisit atau menggunakan makro Button_SetNote. |
| BCM_SETSHIELD | Mengatur status elevasi yang diperlukan untuk tombol atau tautan perintah tertentu untuk menampilkan ikon yang ditingkatkan. Kirim pesan ini secara eksplisit atau dengan menggunakan makro Button_SetElevationRequiredState. |
| BCM_SETSPLITINFO | Mengatur informasi untuk kontrol tombol terpisah. Kirim pesan ini secara eksplisit atau dengan menggunakan makro Button_SetSplitInfo. |
| BCM_SETTEXTMARGIN | Pesan BCM_SETTEXTMARGIN mengatur margin untuk menggambar teks dalam kontrol tombol. |
| BM_CLICK | Mensimulasikan pengguna mengklik tombol. Pesan ini menyebabkan tombol menerima pesan WM_LBUTTONDOWN dan WM_LBUTTONUP, dan jendela induk tombol menerima kode pemberitahuan BN_CLICKED. |
| BM_GETCHECK | Mendapatkan status centang tombol radio atau kotak centang. Anda dapat mengirim pesan ini secara eksplisit atau menggunakan makro Button_GetCheck. |
| BM_GETIMAGE | Mengambil handel ke gambar (ikon atau bitmap) yang terkait dengan tombol . |
| BM_GETSTATE | Mengambil status tombol atau kotak centang. Anda dapat mengirim pesan ini secara eksplisit atau menggunakan makro Button_GetState. |
| BM_SETCHECK | Mengatur status centang tombol radio atau kotak centang. Anda dapat mengirim pesan ini secara eksplisit atau dengan menggunakan makro Button_SetCheck. |
| BM_SETDONTCLICK | Mengatur bendera pada tombol radio yang mengontrol pembuatan pesan BN_CLICKED saat tombol menerima fokus. |
| BM_SETIMAGE | Mengaitkan gambar baru (ikon atau bitmap) dengan tombol . |
| BM_SETSTATE | Mengatur status sorotan tombol. Status sorotan menunjukkan apakah tombol disorot seolah-olah pengguna telah mendorongnya. Anda dapat mengirim pesan ini secara eksplisit atau menggunakan makro Button_SetState. |
| BM_SETSTYLE | Mengatur gaya tombol. Anda dapat mengirim pesan ini secara eksplisit atau menggunakan makro Button_SetStyle. |
Notifications
| Topik | Konten |
|---|---|
| BCN_DROPDOWN | Dikirim saat pengguna mengklik panah turun bawah pada tombol. Jendela induk kontrol menerima kode pemberitahuan ini dalam bentuk pesan WM_NOTIFY. |
| BCN_HOTITEMCHANGE | Memberi tahu pemilik kontrol tombol bahwa mouse memasuki atau meninggalkan area klien kontrol tombol. Kontrol tombol mengirimkan kode pemberitahuan ini dalam bentuk pesan WM_NOTIFY. |
| BN_CLICKED | Dikirim saat pengguna mengklik tombol. Jendela induk tombol menerima kode pemberitahuan BN_CLICKED melalui pesan WM_COMMAND . |
| BN_DBLCLK | Dikirim saat pengguna mengklik dua kali tombol. Kode pemberitahuan ini dikirim secara otomatis untuk tombol BS_USERBUTTON, BS_RADIOBUTTON, dan BS_OWNERDRAW. Jenis tombol lain mengirim BN_DBLCLK hanya jika memiliki gaya BS_NOTIFY. Jendela induk tombol menerima kode pemberitahuan BN_DBLCLK melalui pesan WM_COMMAND . |
| BN_DISABLE | Dikirim saat tombol dinonaktifkan. Catatan: Kode pemberitahuan ini disediakan hanya untuk kompatibilitas dengan Windows versi 16-bit yang lebih lama dari versi 3.0. Aplikasi harus menggunakan gaya tombol BS_OWNERDRAW dan struktur DRAWITEMSTRUCT untuk tugas ini. Jendela induk tombol menerima kode pemberitahuan BN_DISABLE melalui pesan WM_COMMAND . |
| BN_DOUBLECLICKED | Dikirim saat pengguna mengklik dua kali tombol. Kode pemberitahuan ini dikirim secara otomatis untuk tombol BS_USERBUTTON, BS_RADIOBUTTON, dan BS_OWNERDRAW. Jenis tombol lain mengirim BN_DOUBLECLICKED hanya jika memiliki gaya BS_NOTIFY. Jendela induk tombol menerima kode pemberitahuan BN_DOUBLECLICKED melalui pesan WM_COMMAND . |
| BN_HILITE | Dikirim saat pengguna memilih tombol. Catatan: Kode pemberitahuan ini disediakan hanya untuk kompatibilitas dengan Windows versi 16-bit yang lebih lama dari versi 3.0. Aplikasi harus menggunakan gaya tombol BS_OWNERDRAW dan struktur DRAWITEMSTRUCT untuk tugas ini. Jendela induk tombol menerima kode pemberitahuan BN_HILITE melalui pesan WM_COMMAND . |
| BN_KILLFOCUS | Dikirim saat tombol kehilangan fokus keyboard. Tombol harus memiliki gaya BS_NOTIFY untuk mengirim kode pemberitahuan ini. Jendela induk tombol menerima kode pemberitahuan BN_KILLFOCUS melalui pesan WM_COMMAND . |
| BN_PAINT | Dikirim ketika tombol harus dicat. Catatan: Kode pemberitahuan ini disediakan hanya untuk kompatibilitas dengan Windows versi 16-bit yang lebih lama dari versi 3.0. Aplikasi harus menggunakan gaya tombol BS_OWNERDRAW dan struktur DRAWITEMSTRUCT untuk tugas ini. Jendela induk tombol menerima kode pemberitahuan BN_PAINT melalui pesan WM_COMMAND . |
| BN_PUSHED | Dikirim saat status pendorongan tombol diatur ke didorong. Catatan: Kode pemberitahuan ini disediakan hanya untuk kompatibilitas dengan Windows versi 16-bit yang lebih lama dari versi 3.0. Aplikasi harus menggunakan gaya tombol BS_OWNERDRAW dan struktur DRAWITEMSTRUCT untuk tugas ini. Jendela induk tombol menerima kode pemberitahuan BN_PUSHED melalui pesan WM_COMMAND . |
| BN_SETFOCUS | Dikirim saat tombol menerima fokus keyboard. Tombol harus memiliki gaya BS_NOTIFY untuk mengirim kode pemberitahuan ini. Jendela induk tombol menerima kode pemberitahuan BN_SETFOCUS melalui pesan WM_COMMAND . |
| BN_UNHILITE | Dikirim saat sorotan harus dihapus dari tombol. Catatan: Kode pemberitahuan ini disediakan hanya untuk kompatibilitas dengan Windows versi 16-bit yang lebih lama dari versi 3.0. Aplikasi harus menggunakan gaya tombol BS_OWNERDRAW dan struktur DRAWITEMSTRUCT untuk tugas ini. Jendela induk tombol menerima kode pemberitahuan BN_UNHILITE melalui pesan WM_COMMAND . |
| BN_UNPUSHED | Dikirim saat status pendorongan tombol diatur ke dilepas. Catatan: Kode pemberitahuan ini disediakan hanya untuk kompatibilitas dengan Windows versi 16-bit yang lebih lama dari versi 3.0. Aplikasi harus menggunakan gaya tombol BS_OWNERDRAW dan struktur DRAWITEMSTRUCT untuk tugas ini. Jendela induk tombol menerima kode pemberitahuan BN_UNPUSHED melalui pesan WM_COMMAND . |
| NM_CUSTOMDRAW (tombol) | Memberi tahu jendela induk kontrol tombol tentang operasi gambar kustom pada tombol . Kontrol tombol mengirimkan kode pemberitahuan ini dalam bentuk pesan WM_NOTIFY. |
| WM_CTLCOLORBTN | Pesan WM_CTLCOLORBTN dikirim ke jendela induk tombol sebelum menggambar tombol. Jendela induk dapat mengubah teks tombol dan warna latar belakang. Namun, hanya tombol yang digambar pemilik yang merespons jendela induk yang memproses pesan ini. |
Struktur
| Topik | Konten |
|---|---|
| BUTTON_IMAGELIST | Berisi informasi tentang daftar gambar yang digunakan dengan kontrol tombol. |
| BUTTON_SPLITINFO | Berisi informasi yang menentukan tombol pisah (gaya BS_SPLITBUTTON dan BS_DEFSPLITBUTTON). Digunakan dengan pesan BCM_GETSPLITINFO dan BCM_SETSPLITINFO. |
| NMBCDROPDOWN | Berisi informasi tentang pemberitahuan BCN_DROPDOWN . |
| NMBCHOTITEM | Berisi informasi tentang pergerakan mouse di atas kontrol tombol. |
Konstanta
| Topik | Konten |
|---|---|
| Gaya Tombol | Menentukan kombinasi gaya tombol. Jika Anda membuat tombol menggunakan kelas BUTTON dengan fungsi CreateWindow atau CreateWindowEx, Anda dapat menentukan salah satu gaya tombol yang tercantum di bawah ini. |