Parameter Kontrol Umum

Berikut ini menguraikan sintaks umum untuk pernyataan definisi sumber daya kontrol. Arti dari setiap parameter diberikan di bawah ini. Terkadang, pernyataan akan menggunakan parameter secara berbeda, atau dapat mengabaikan parameter. Variasi khusus pernyataan dijelaskan dalam dokumentasi untuk pernyataan tersebut.

control [[text,]] id, x, y, width, height[[, style[[, extended-style]]]][, helpId]
[{ data-element-1 [, data-element-2 [,  . . . ]]}]

text

Teks yang akan ditampilkan dengan kontrol. Teks diposisikan dalam kontrol atau berdekatan dengan kontrol.

Parameter ini harus berisi nol atau lebih karakter yang diapit dalam tanda kutip ganda ("). String secara otomatis dihentikan null dan dikonversi ke Unicode dalam file sumber daya yang dihasilkan.

Secara default, karakter yang tercantum di antara tanda kutip ganda adalah karakter ANSI, dan urutan escape ditafsirkan sebagai urutan escape byte. Jika string didahului oleh awalan "L", string adalah string karakter lebar dan urutan escape ditafsirkan sebagai urutan escape 2 byte yang menentukan karakter Unicode. Jika tanda kutip ganda diperlukan dalam teks, Anda harus menyertakan tanda kutip ganda dua kali.

Karakter ampersand (&) dalam teks menunjukkan bahwa karakter berikut digunakan sebagai karakter mnemonic untuk kontrol. Ketika kontrol ditampilkan, ampersand tidak ditampilkan, tetapi karakter mnemonic digaris bawahi. Pengguna dapat memilih kontrol dengan menekan tombol yang sesuai dengan karakter mnemonic yang digaris bawahi. Untuk menggunakan ampersand sebagai karakter dalam string, sisipkan dua ampersands (&&&).

id

Pengidentifikasi kontrol. Nilai ini harus berupa bilangan bulat yang tidak ditandatangani 16-bit dalam rentang 0 hingga 65.535 atau ekspresi aritmatika sederhana yang mengevaluasi ke nilai dalam rentang tersebut.

x

Koordinat X dari sisi kiri kontrol relatif terhadap sisi kiri kotak dialog. Nilai ini harus berupa bilangan bulat yang tidak ditandatangani 16-bit dalam rentang 0 hingga 65.535. Koordinat berada dalam unit dialog dan relatif terhadap asal kotak dialog, jendela, atau kontrol yang berisi kontrol yang ditentukan.

y

Koordinat Y dari sisi atas kontrol relatif terhadap bagian atas kotak dialog. Nilai ini harus berupa bilangan bulat yang tidak ditandatangani 16-bit dalam rentang 0 hingga 65.535. Koordinat berada dalam unit dialog relatif terhadap asal kotak dialog, jendela, atau kontrol yang berisi kontrol yang ditentukan.

width

Lebar kontrol. Nilai ini harus berupa bilangan bulat yang tidak ditandatangani 16-bit dalam rentang 1 hingga 65.535. Lebar dalam satuan 1/4 karakter.

height

Tinggi kontrol. Nilai ini harus berupa bilangan bulat yang tidak ditandatangani 16-bit dalam rentang 1 hingga 65.535. Tingginya dalam satuan 1/8 karakter.

Gaya

Gaya kontrol. Gunakan operator bitwise OR (|) untuk menggabungkan gaya. Untuk informasi selengkapnya, lihat Gaya Jendela.

gaya yang diperluas

Gaya jendela yang diperluas. Anda harus menentukan gaya untuk menentukan gaya yang diperluas. Untuk informasi selengkapnya, lihat EXSTYLE.

helpId

Ekspresi numerik yang menunjukkan ID yang digunakan untuk mengidentifikasi kontrol selama pemrosesan WM_HELP.

controlData

Data khusus kontrol untuk kontrol. Saat dialog dibuat, dan kontrol dalam dialog yang memiliki data khusus kontrol dibuat, penunjuk ke data tersebut diteruskan ke prosedur jendela kontrol melalui lParam pesan WM_CREATE untuk kontrol tersebut.

Keterangan

Unit dialog horizontal adalah 1/4 dari unit lebar dasar dialog. Unit vertikal adalah 1/8 dari unit tinggi dasar dialog. Unit dasar dialog saat ini dihitung dari tinggi dan lebar font sistem saat ini. Fungsi GetDialogBaseUnits mengembalikan unit dasar dialog dalam piksel. Koordinat relatif terhadap asal kotak dialog.