Struktur DLGTEMPLATEEX

Artikel
06/12/2023

Templat kotak dialog yang diperluas dimulai dengan header DLGTEMPLATEEX yang menjelaskan kotak dialog dan menentukan jumlah kontrol dalam kotak dialog. Untuk setiap kontrol dalam kotak dialog, templat kotak dialog yang diperluas memiliki blok data yang menggunakan format DLGITEMTEMPLATEEX untuk menjelaskan kontrol.

Struktur DLGTEMPLATEEX tidak ditentukan dalam file header standar apa pun. Definisi struktur disediakan di sini untuk menjelaskan format templat yang diperluas untuk kotak dialog.

Sintaks

typedef struct {
  WORD      dlgVer;
  WORD      signature;
  DWORD     helpID;
  DWORD     exStyle;
  DWORD     style;
  WORD      cDlgItems;
  short     x;
  short     y;
  short     cx;
  short     cy;
  sz_Or_Ord menu;
  sz_Or_Ord windowClass;
  WCHAR     title[titleLen];
  WORD      pointsize;
  WORD      weight;
  BYTE      italic;
  BYTE      charset;
  WCHAR     typeface[stringLen];
} DLGTEMPLATEEX;

Anggota

dlgVer

Ketik: WORD

Nomor versi templat kotak dialog yang diperluas. Anggota ini harus diatur ke 1.

Tanda tangan

Ketik: WORD

Menunjukkan apakah templat adalah templat kotak dialog yang diperluas. Jika tanda tangan 0xFFFF, ini adalah templat kotak dialog yang diperluas. Dalam hal ini, anggota dlgVer menentukan nomor versi templat. Jika tanda tangan adalah nilai apa pun selain 0xFFFF, ini adalah templat kotak dialog standar yang menggunakan struktur DLGTEMPLATE dan DLGITEMTEMPLATE .

helpID

Jenis: DWORD

Pengidentifikasi konteks bantuan untuk jendela kotak dialog. Ketika sistem mengirim pesan WM_HELP , sistem meneruskan nilai ini di anggota wContextId dari struktur HELPINFO .

exStyle

Jenis: DWORD

Gaya jendela yang diperluas. Anggota ini tidak digunakan saat membuat 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 kotak dialog. Anggota ini bisa menjadi kombinasi nilai gaya jendela dan nilai gaya kotak dialog.

Jika gaya menyertakan gaya kotak dialog DS_SETFONT atau DS_SHELLFONT , header DLGTEMPLATEEX dari templat kotak dialog yang diperluas berisi empat anggota tambahan ( menunjuk, berat, miring, dan typeface) yang menjelaskan font yang akan digunakan untuk teks di area klien dan kontrol kotak dialog. Jika memungkinkan, sistem membuat font sesuai dengan nilai yang ditentukan dalam anggota ini. Kemudian sistem mengirim pesan WM_SETFONT ke kotak dialog dan ke setiap kontrol untuk menyediakan handel ke font.

Untuk informasi selengkapnya, lihat Font Kotak Dialog.

cDlgItems

Ketik: WORD

Jumlah kontrol dalam kotak dialog.

x

Jenis: pendek

Koordinat x, dalam unit kotak dialog, dari sudut kiri atas kotak dialog.

y

Jenis: pendek

Koordinat y, dalam unit kotak dialog, sudut kiri atas kotak dialog.

Cx

Jenis: pendek

Lebar, dalam unit kotak dialog, dari kotak dialog.

Cy

Jenis: pendek

Tinggi, dalam unit kotak dialog, dari kotak dialog.

menu

Jenis: sz_Or_Ord

Array panjang variabel elemen 16-bit yang mengidentifikasi sumber daya menu untuk kotak dialog. Jika elemen pertama array ini 0x0000, kotak dialog tidak memiliki menu dan array tidak memiliki elemen lain. Jika elemen pertama 0xFFFF, array memiliki satu elemen tambahan yang menentukan nilai ordinal sumber daya menu dalam file yang dapat dieksekusi. Jika elemen pertama memiliki nilai lain, sistem memperlakukan array sebagai string Unicode yang dihentikan null yang menentukan nama sumber daya menu dalam file yang dapat dieksekusi.

windowClass

Jenis: sz_Or_Ord

Array panjang variabel elemen 16-bit yang mengidentifikasi kelas jendela kotak dialog. Jika elemen pertama array 0x0000, sistem menggunakan kelas kotak dialog yang telah ditentukan sebelumnya untuk kotak dialog dan array tidak memiliki elemen lain. Jika elemen pertama 0xFFFF, array memiliki satu elemen tambahan yang menentukan nilai ordinal dari kelas jendela sistem yang telah ditentukan sebelumnya. Jika elemen pertama memiliki nilai lain, sistem memperlakukan array sebagai string Unicode yang dihentikan null yang menentukan nama kelas jendela terdaftar.

judul

Jenis: WCHAR[titleLen]

Judul kotak dialog. Jika elemen pertama array ini 0x0000, kotak dialog tidak memiliki judul dan array tidak memiliki elemen lain.

menunjuk

Ketik: WORD

Ukuran titik font yang digunakan untuk teks dalam kotak dialog dan kontrolnya.