Kontrol RadioButtonGroup

Kontrol RadioButtonGroup adalah sekelompok tombol radio. Ini memungkinkan pengguna untuk memilih string atau nilai bilangan bulat untuk properti dari daftar nilai yang telah ditentukan. Anda dapat mengaitkan kontrol ini dengan properti dengan memasukkan nama properti ke dalam kolom Properti dari tabel Kontrol. Tentukan nilai yang mungkin untuk pilihan di kolom Nilai tabel RadioButton. Perhatikan bahwa string yang ditampilkan belum tentu sama dengan nilai yang dipilih pengguna.

Setiap kontrol RadioButtonGroup dikaitkan dengan properti. Nilai default untuk properti ini harus diinisialisasi dalam tabel Properti. Dalam setiap RadioButtonGroup yang ditentukan dalam tabel RadioButton, mungkin ada satu tombol radio yang memiliki nilai di bidang Nilai yang cocok dengan nilai default untuk properti ini. Ini adalah tombol default untuk kontrol RadioButtonGroup. Tombol Default awalnya ditampilkan seperti yang dipilih dalam kontrol.

Perhatikan bahwa fokus pada kotak dialog tidak dapat berpindah ke kontrol RadioButtonGroup hingga salah satu tombol dalam grup telah dipilih. Untuk membuat fokus berpindah ke grup tombol ini, tentukan salah satu tombol sebagai tombol default untuk grup.

Kontrol RadioButtonGroup hanya mengatur nilai properti dan tidak dapat digunakan untuk mengirim ControlEvent.

Implementasi memperlakukan seluruh grup sebagai satu kontrol, oleh karena itu tidak mungkin untuk menyembunyikan atau menonaktifkan tombol individual dalam grup. Demikian pula semua tombol harus memiliki gaya yang sama, yaitu, semuanya memiliki teks atau semuanya memiliki bitmap (atau fitur serupa lainnya). Posisi tombol ditulis relatif terhadap grup. Dengan cara ini seluruh grup dapat dipindahkan dengan hanya mengubah koordinat grup tanpa mengubah tombol individual. Pada pembuatan kontrol, memverifikasi bahwa tombol individual tidak meluas di luar batas grup.

Atribut Kontrol

Anda dapat menggunakan atribut berikut dengan kontrol ini. Untuk mengubah nilai atribut menggunakan peristiwa, berlangganan kontrol ke ControlEvent di tabel EventMapping dan cantumkan pengidentifikasi atribut di kolom Atribut. Masukkan pengidentifikasi ControlEvent di kolom Peristiwa.

Pengidentifikasi atribut	Bit heksadesimal	Deskripsi
IndirectPropertyName		Ini adalah nama properti tidak langsung yang terkait dengan kontrol. Jika bit atribut Tidak Langsung diatur, kontrol akan menampilkan atau mengubah nilai properti yang memiliki nama ini. Jika bit atribut Tidak Langsung diatur, nama ini juga merupakan nilai properti yang tercantum di kolom Properti dari tabel Kontrol.
Posisi		Posisi kontrol dalam kotak dialog. Masukkan lebar, tinggi, dan koordinat kontrol sudut kiri kontrol ke kolom Lebar, Tinggi, X, dan Y tabel Kontrol. Gunakan unit alat penginstal untuk panjang dan jarak.
PropertyName		Ini adalah nama properti yang terkait dengan kontrol ini. Jika bit atribut Tidak Langsung tidak diatur, kontrol akan menampilkan atau mengubah nilai properti yang memiliki nama ini. Atribut ini ditentukan dalam kolom Properti dari tabel Kontrol.
PropertyValue		Nilai properti saat ini ditampilkan atau diubah oleh kontrol ini. Jika bit atribut Tidak Langsung tidak diatur, ini adalah nilai PropertyName. Jika bit atribut Tidak Langsung diatur, ini adalah nilai IndirectPropertyName. Jika atribut berubah, kontrol mencerminkan nilai baru.
Teks		Atribut kontrol ini dapat menentukan teks yang ditampilkan oleh kontrol, gambar yang disimpan dalam tabel Biner, atau set gambar pada waktu proses. Untuk menentukan teks, masukkan string teks ke dalam kolom Teks tabel Kontrol. Untuk mengatur font dan gaya font teks ini, awali string karakter yang ditampilkan dengan {\style} atau {&style}. Di mana gaya adalah pengidentifikasi yang tercantum di kolom TextStyle dari tabel TextStyle. Jika tidak ada, tetapi properti DefaultUIFont didefinisikan sebagai gaya teks yang valid, font tersebut akan digunakan. Untuk menentukan ikon atau gambar bitmap yang disimpan dalam tabel Biner, masukkan kunci utama rekaman gambar dari kolom Nama tabel Biner ke dalam kolom Teks rekaman tabel Kontrol untuk kontrol.
Dapat dilihat	0x00000000 0x00000001	Kontrol tersembunyi. Kontrol yang terlihat. Sertakan bit ini dalam kata bit kolom Atribut dalam tabel Kontrol untuk membuat kontrol terlihat atau tersembunyi pada pembuatannya. Anda juga dapat menyembunyikan atau memperlihatkan kontrol dengan menggunakan tabel ControlCondition.
Diaktifkan	0x00000000 0x00000002	Kontrol dalam status dinonaktifkan. Kontrol dalam status diaktifkan. Sertakan bit ini di kolom Atribut Kontrol untuk mengaktifkan kontrol pada pembuatan. Anda juga dapat mengaktifkan atau menonaktifkan kontrol dengan menggunakan tabel ControlCondition.
Cekung	0x00000000 0x00000004	Menampilkan gaya visual default. Menampilkan kontrol dengan tampilan tenggelam, 3-D. Sertakan bit ini dalam kata bit di kolom Atribut dari tabel Kontrol.
Langsung	0x00000000 0x00000008	Kontrol menampilkan atau mengubah nilai properti di kolom Properti dari tabel Kontrol. Kontrol menampilkan atau mengubah nilai properti yang memiliki pengidentifikasi yang tercantum di kolom Properti dari tabel Kontrol. Menentukan apakah properti yang terkait dengan kontrol ini dirujuk secara tidak langsung.
Bilangan bulat	0x00000000 0x00000010	Properti yang terkait dengan kontrol adalah nilai string. Properti yang terkait dengan kontrol adalah nilai bilangan bulat. Sertakan bit ini dalam kata bit dari kolom Atribut tabel Kontrol untuk mengatur atribut ini pada pembuatan kontrol.
RTLRO	0x00000000 0x00000020	Teks dalam kontrol ditampilkan dalam urutan pembacaan kiri-ke-kanan. Teks dalam kontrol ditampilkan dalam urutan baca kanan-ke-kiri.
RightAligned	0x00000000 0x00000040	Teks dalam kontrol diratakan ke kiri. Teks dalam kontrol diratakan ke kanan.
PushLike	0x00000000 0x00020000	Kontrol digambar dengan penampilannya yang biasa. Kontrol memiliki gaya BS_PUSHLIKE, dan digambar untuk muncul sebagai tombol tekan. Sertakan bit ini dalam kata bit dari kolom Atribut tabel Kontrol untuk mengatur atribut ini pada pembuatan kontrol.
Bitmap	0x00000000 0x00040000	Teks dalam kontrol ditentukan dalam kolom Teks dari tabel Kontrol. Kontrol memiliki gaya BS_BITMAP, teks dalam kontrol digantikan oleh gambar bitmap. Kolom Teks dalam tabel Kontrol digunakan sebagai kunci asing ke tabel Biner. Sertakan bit ini dalam kata bit di kolom Atribut tabel Kontrol. Jangan atur bit gaya Ikon dan Bitmap secara bersamaan. Tombol tidak boleh berisi gambar bitmap dan teks. Untuk mengatur font dan gaya font string teks, awali string karakter yang ditampilkan dengan {\style} atau {&style}. Di mana gaya adalah pengidentifikasi yang tercantum di kolom TextStyle dari tabel TextStyle. Jika tidak ada, tetapi properti DefaultUIFont didefinisikan sebagai gaya teks yang valid, font tersebut akan digunakan.
Ikon	0x00000000 0x00080000	Teks dalam kontrol ditentukan dalam kolom Teks dari tabel Kontrol. Kontrol memiliki gaya BS_ICON, teks dalam kontrol digantikan oleh gambar ikon. Kolom Teks dalam tabel Kontrol digunakan sebagai kunci asing ke tabel Biner. Sertakan bit ini dalam kata bit di kolom Atribut tabel Kontrol. Jangan atur bit Ikon dan Bitmap secara bersamaan. Tombol tidak boleh berisi gambar ikon dan teks. Untuk mengatur font dan gaya font string teks, awali string karakter yang ditampilkan dengan {\style} atau {&style}. Di mana gaya adalah pengidentifikasi yang tercantum di kolom TextStyle dari tabel TextStyle. Jika tidak ada, tetapi properti DefaultUIFont didefinisikan sebagai gaya teks yang valid, font tersebut akan digunakan.
FixedSize	0x00000000 0x00100000	Regangkan gambar ikon agar pas dengan kontrol. Potong atau tengahkan gambar ikon dalam kontrol. Sertakan bit ini dalam kata bit kolom Atribut dari tabel Kontrol.
Ukuran Ikon	0x00000000 0x00200000 0x00400000 0x00600000	Memuat gambar pertama. Memuat gambar 16x16 pertama. Memuat gambar 32x32 pertama. Memuat gambar 48x48 pertama. File ikon dapat berisi gambar ukuran yang berbeda dari ikon yang sama. Sertakan nilai kata bit yang sesuai di kolom Atribut dari tabel Kontrol Jika bit ini tidak diatur, alat penginstal mengabaikan atribut FixedSize dan gambar direntangkan agar sesuai dengan persegi kontrol. Jika bit IconSize dan bit FixedSize diatur, gambar yang lebih kecil dari kontrol dipusatkan dan gambar lebih besar dari kontrol yang dikecilkan agar pas.
HasBorder	tidak diatur 0x01000000	Tidak ada batas dan tanpa teks. Menampilkan batas dan teks. Sertakan 16777216 dalam kata bit di kolom Atribut Kontrol untuk menampilkan batas dan teks.

 

Keterangan

Karena cara Windows menggambar bingkai, ada kesenjangan antara bagian atas jendela kontrol dan bingkai yang terlihat, bahkan ketika tidak ada keterangan.

Kontrol ini dapat dibuat dari kelas BUTTON dengan menggunakan fungsi CreateWindowEx. Jika bit HasBorder diatur, ia memiliki gaya BS_GROUPBOX, jika tidak, ia memiliki gaya BS_OWNERDRAW.

Kontrol RadioButtonGroup tidak boleh tumpang tindih dengan kontrol lain dan kontrol lain tidak boleh tumpang tindih dengan RadioButtonGroup. Tumpang tindih kontrol ini dan kontrol lainnya dapat menyebabkan kontrol berfungsi atau ditampilkan dengan tidak benar. Untuk menyediakan program pembaca layar dengan teks deskriptif tambahan tentang kontrol RadioButtonGroup, ikuti contoh yang disediakan dalam Menambahkan Teks Ekstra ke Tombol Radio.