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.