Bagikan melalui


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.

Contoh

HRESULT Button::CreateText(HWND hParent, const TCHAR *szCaption, int nID, 
                               const Rect& rcBound)
{
    CREATESTRUCT create;
	ZeroMemory(&create, sizeof(CREATESTRUCT));

    create.x = rcBound.left;
    create.y = rcBound.top;
    create.cx = rcBound.right - create.x;
    create.cy = rcBound.bottom - create.y;

    create.hwndParent = hParent;
    create.lpszName = szCaption;
    create.hMenu = (HMENU)(INT_PTR)nID;
    create.lpszClass = TEXT("BUTTON");
    create.style = BS_PUSHBUTTON | BS_FLAT;
    return Control::Create(create);
}

Contoh dari Sampel Klasik Windows di GitHub.

Konstanta

Terus-menerus Deskripsi
BS_3STATE
Membuat tombol yang sama dengan kotak centang, kecuali bahwa kotak dapat berwarna abu-abu serta dicentang atau dikosongkan. Gunakan status abu-abu untuk memperlihatkan bahwa status kotak centang tidak ditentukan.
BS_AUTO3STATE
Membuat tombol yang sama dengan kotak centang tiga status, kecuali bahwa kotak mengubah statusnya saat pengguna memilihnya. Status berputar melalui diperiksa, tidak ditentukan, dan dibersihkan.
BS_AUTOCHECKBOX
Membuat tombol yang sama dengan kotak centang, kecuali bahwa status centang secara otomatis beralih antara dicentang dan dikosongkan setiap kali pengguna memilih kotak centang.
BS_AUTORADIOBUTTON
Membuat tombol yang sama dengan tombol radio, kecuali bahwa ketika pengguna memilihnya, sistem secara otomatis mengatur status pemeriksaan tombol untuk diperiksa dan secara otomatis mengatur status pemeriksaan untuk semua tombol lain dalam grup yang sama untuk dibersihkan.
BS_BITMAP
Menentukan bahwa tombol menampilkan bitmap. Lihat bagian Keterangan untuk interaksinya dengan BS_ICON.
BS_BOTTOM
Tempatkan teks di bagian bawah persegi tombol.
BS_CENTER
Tengahkan teks secara horizontal dalam persegi tombol.
BS_CHECKBOX
Membuat kotak centang kecil dan kosong dengan teks. Secara default, teks ditampilkan di sebelah kanan kotak centang. Untuk menampilkan teks di sebelah kiri kotak centang, gabungkan bendera ini dengan gaya BS_LEFTTEXT (atau dengan gaya BS_RIGHTBUTTON yang setara).
BS_COMMANDLINK
Membuat tombol tautan perintah yang bertingkah seperti tombol gaya BS_PUSHBUTTON, tetapi tombol tautan perintah memiliki panah hijau di sebelah kiri yang menunjuk ke teks tombol. Caption untuk teks tombol dapat diatur dengan mengirim pesan BCM_SETNOTE ke tombol .
BS_DEFCOMMANDLINK
Membuat tombol tautan perintah yang berkinerja seperti tombol gaya BS_PUSHBUTTON. Jika tombol berada dalam kotak dialog, pengguna dapat memilih tombol tautan perintah dengan menekan tombol ENTER, bahkan ketika tombol tautan perintah tidak memiliki fokus input. Gaya ini berguna untuk memungkinkan pengguna dengan cepat memilih opsi (default) yang paling mungkin.
BS_DEFPUSHBUTTON
Membuat tombol tekan yang bertingkah seperti tombol gaya BS_PUSHBUTTON, tetapi memiliki tampilan yang berbeda. Jika tombol berada dalam kotak dialog, pengguna dapat memilih tombol dengan menekan tombol ENTER, bahkan ketika tombol tidak memiliki fokus input. Gaya ini berguna untuk memungkinkan pengguna dengan cepat memilih opsi (default) yang paling mungkin.
BS_DEFSPLITBUTTON
Membuat tombol pisah yang berperilaku seperti tombol gaya BS_PUSHBUTTON, tetapi juga memiliki tampilan yang khas. Jika tombol pisah berada dalam kotak dialog, pengguna dapat memilih tombol pisahkan dengan menekan tombol ENTER, bahkan ketika tombol pisahkan tidak memiliki fokus input. Gaya ini berguna untuk memungkinkan pengguna dengan cepat memilih opsi (default) yang paling mungkin.
BS_GROUPBOX
Membuat persegi panjang di mana kontrol lain dapat dikelompokkan. Teks apa pun yang terkait dengan gaya ini ditampilkan di sudut kiri atas persegi.
BS_ICON
Menentukan bahwa tombol menampilkan ikon. Lihat bagian Keterangan untuk interaksinya dengan BS_BITMAP.
BS_FLAT
Menentukan bahwa tombol tersebut bersifat dua dimensi; ini tidak menggunakan bayangan default untuk membuat gambar 3-D.
BS_LEFT
Kiri membenarkan teks dalam persegi tombol. Namun, jika tombol adalah kotak centang atau tombol radio yang tidak memiliki gaya BS_RIGHTBUTTON, teks dibiarkan dibenarkan di sisi kanan kotak centang atau tombol radio.
BS_LEFTTEXT
Tempatkan teks di sisi kiri tombol radio atau kotak centang jika dikombinasikan dengan tombol radio atau gaya kotak centang. Sama seperti gaya BS_RIGHTBUTTON.
BS_MULTILINE
Membungkus teks tombol ke beberapa baris jika string teks terlalu panjang untuk dipaskan pada satu baris dalam persegi panjang tombol.
BS_NOTIFY
Mengaktifkan tombol untuk mengirim BN_KILLFOCUS dan BN_SETFOCUS kode pemberitahuan ke jendela induknya.
Perhatikan bahwa tombol mengirim kode pemberitahuan BN_CLICKED terlepas dari apakah tombol tersebut memiliki gaya ini. Untuk mendapatkan kode pemberitahuan BN_DBLCLK , tombol harus memiliki gaya BS_RADIOBUTTON atau BS_OWNERDRAW.
BS_OWNERDRAW
Membuat tombol yang digambar pemilik. Jendela pemilik menerima pesan WM_DRAWITEM ketika aspek visual tombol telah berubah. Jangan gabungkan gaya BS_OWNERDRAW dengan gaya tombol lainnya.
BS_PUSHBUTTON
Membuat tombol tekan yang memposting pesan WM_COMMAND ke jendela pemilik saat pengguna memilih tombol.
BS_PUSHLIKE
Membuat tombol (seperti kotak centang, kotak centang tiga status, atau tombol radio) terlihat dan bertindak seperti tombol tekan. Tombol terlihat dinaikkan ketika tidak didorong atau dicentang, dan tenggelam saat didorong atau dicentang.
BS_RADIOBUTTON
Membuat lingkaran kecil dengan teks. Secara default, teks ditampilkan di sebelah kanan lingkaran. Untuk menampilkan teks di sebelah kiri lingkaran, gabungkan bendera ini dengan gaya BS_LEFTTEXT (atau dengan gaya BS_RIGHTBUTTON yang setara). Gunakan tombol radio untuk grup pilihan terkait, tetapi saling eksklusif.
BS_RIGHT
Membenarkan teks di persegi tombol. Namun, jika tombol adalah kotak centang atau tombol radio yang tidak memiliki gaya BS_RIGHTBUTTON, teks tepat dibenarkan di sisi kanan kotak centang atau tombol radio.
BS_RIGHTBUTTON
Memposisikan lingkaran tombol radio atau kotak centang persegi di sisi kanan persegi tombol. Sama seperti gaya BS_LEFTTEXT.
BS_SPLITBUTTON
Membuat tombol pisah. Tombol pisah memiliki panah turun bawah.
BS_TEXT
Menentukan bahwa tombol menampilkan teks.
BS_TOP
Tempatkan teks di bagian atas persegi tombol.
BS_TYPEMASK
Jangan gunakan gaya ini. Bit gaya komposit yang dihasilkan dari penggunaan operator OR pada bit gaya BS_*. Ini dapat digunakan untuk menutupi bit BS_* yang valid dari bitmask tertentu. Perhatikan bahwa ini sudah kedaluarsa dan tidak menyertakan semua gaya yang valid dengan benar. Dengan demikian, Anda tidak boleh menggunakan gaya ini.
BS_USERBUTTON
Usang, tetapi disediakan untuk kompatibilitas dengan Windows versi 16-bit. Aplikasi harus menggunakan BS_OWNERDRAW sebagai gantinya.
BS_VCENTER
Menempatkan teks di tengah (vertikal) persegi panjang tombol.

Keterangan

Untuk ilustrasi gaya tombol utama seperti BS_CHECKBOX dan BS_GROUPBOX, lihat Jenis Tombol.

Tampilan teks atau ikon atau keduanya pada kontrol tombol bergantung pada gaya BS_ICON dan BS_BITMAP, dan apakah pesan BM_SETIMAGE dikirim. Hasil yang mungkin adalah sebagai berikut.

BS_ICON atau set BS_BITMAP? BM_SETIMAGE menelepon? Hasil
Ya Ya Perlihatkan ikon saja.
Tidak Ya Perlihatkan ikon dan teks.
Ya Tidak Perlihatkan teks saja.
Tidak Tidak Perlihatkan teks saja

Persyaratan

Persyaratan Nilai
Header
Winuser.h