Struktur DLGITEMTEMPLATEEX
Blok teks yang digunakan oleh templat kotak dialog yang diperluas untuk menjelaskan kotak dialog yang diperluas. Untuk deskripsi format templat kotak dialog yang diperluas, lihat DLGTEMPLATEEX.
Sintaks
typedef struct {
DWORD helpID;
DWORD exStyle;
DWORD style;
short x;
short y;
short cx;
short cy;
DWORD id;
sz_Or_Ord windowClass;
sz_Or_Ord title;
WORD extraCount;
} DLGITEMTEMPLATEEX;
Anggota
-
helpID
-
Jenis: DWORD
-
Pengidentifikasi konteks bantuan untuk kontrol. Ketika sistem mengirim pesan WM_HELP , sistem meneruskan nilai helpID di anggota dwContextId dari struktur HELPINFO .
-
exStyle
-
Jenis: DWORD
-
Gaya yang diperluas untuk jendela. Anggota ini tidak digunakan untuk membuat kontrol dalam kotak dialog, tetapi aplikasi yang menggunakan templat kotak dialog dapat menggunakannya untuk membuat jenis jendela lainnya. Untuk daftar nilai, lihat Gaya Jendela yang Diperluas.
-
Gaya
-
Jenis: DWORD
-
Gaya kontrol. Anggota ini bisa menjadi kombinasi nilai gaya jendela (seperti WS_BORDER) dan satu atau beberapa nilai gaya kontrol (seperti BS_PUSHBUTTON dan ES_LEFT).
-
x
-
Jenis: pendek
-
Koordinat x, dalam unit kotak dialog, dari sudut kiri atas kontrol. Koordinat ini selalu relatif terhadap sudut kiri atas area klien kotak dialog.
-
y
-
Jenis: pendek
-
Koordinat y, dalam unit kotak dialog, dari sudut kiri atas kontrol. Koordinat ini selalu relatif terhadap sudut kiri atas area klien kotak dialog.
-
Cx
-
Jenis: pendek
-
Lebar, dalam unit kotak dialog, kontrol.
-
Cy
-
Jenis: pendek
-
Tinggi, dalam unit kotak dialog, kontrol.
-
id
-
Jenis: DWORD
-
Pengidentifikasi kontrol.
-
windowClass
-
Jenis: sz_Or_Ord
-
Array panjang variabel elemen 16-bit yang menentukan kelas jendela kontrol. Jika elemen pertama dari array ini adalah nilai apa pun selain 0xFFFF, sistem memperlakukan array sebagai string Unicode yang dihentikan null yang menentukan nama kelas jendela terdaftar.
Jika elemen pertama 0xFFFF, array memiliki satu elemen tambahan yang menentukan nilai ordinal dari kelas sistem yang telah ditentukan sebelumnya. Ordinal dapat menjadi salah satu nilai atom berikut.
Nilai Makna - 0x0080
Tombol - 0x0081
Edit - 0x0082
Statis - 0x0083
Kotak daftar - 0x0084
Bilah gulir - 0x0085
Kotak kombo -
judul
-
Jenis: sz_Or_Ord
-
Array panjang variabel elemen 16-bit yang berisi teks awal atau pengidentifikasi sumber daya kontrol. Jika elemen pertama dari array ini 0xFFFF, array memiliki satu elemen tambahan yang menentukan nilai ordinal sumber daya, seperti ikon, dalam file yang dapat dieksekusi. Anda dapat menggunakan pengidentifikasi sumber daya untuk kontrol, seperti kontrol ikon statis, yang memuat dan menampilkan ikon atau sumber daya lainnya, bukan teks. Jika elemen pertama adalah nilai selain 0xFFFF, sistem memperlakukan array sebagai string Unicode yang dihentikan null yang menentukan teks awal.
-
extraCount
-
Jenis: WORD
-
Jumlah byte data pembuatan yang mengikuti anggota ini. Jika nilai ini lebih besar dari nol, data pembuatan dimulai pada batas WORD berikutnya. Data pembuatan ini dapat memiliki ukuran dan format apa pun. Prosedur jendela kontrol harus dapat menginterpretasikan data. Ketika sistem membuat kontrol, sistem meneruskan penunjuk ke data ini dalam parameter lParam dari pesan WM_CREATE yang dikirim ke kontrol.
Keterangan
Templat yang diperluas untuk kotak dialog terdiri dari header DLGTEMPLATEEX diikuti oleh struktur DLGITEMTEMPLATEEX untuk setiap kontrol dalam kotak dialog.
Setiap struktur DLGITEMTEMPLATEEX harus diselaraskan pada batas DWORD . WindowClass panjang variabel dan array judul harus diratakan pada batas WORD. Array data pembuatan, jika ada, harus diratakan pada batas WORD .
Jika Anda menentukan string karakter di windowClass dan array judul , Anda harus menggunakan string Unicode. Gunakan fungsi MultiByteToWideChar untuk menghasilkan string Unicode dari string ANSI.
Anggota x, y, cx, dan cy menentukan nilai dalam unit kotak dialog. Anda dapat mengonversi nilai ini ke unit layar (piksel) dengan menggunakan fungsi MapDialogRect .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung |
Windows 2000 Server [hanya aplikasi desktop] |
Lihat juga
-
Referensi
-
Konseptual
-
Sumber Daya Lainnya