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.