Struktur DLGTEMPLATE (winuser.h)

Artikel
03/13/2023

Menentukan dimensi dan gaya kotak dialog. Struktur ini, selalu yang pertama dalam templat standar untuk kotak dialog, juga menentukan jumlah kontrol dalam kotak dialog dan karena itu menentukan jumlah struktur DLGITEMTEMPLATE berikutnya dalam templat.

Sintaks

typedef struct {
  DWORD style;
  DWORD dwExtendedStyle;
  WORD  cdit;
  short x;
  short y;
  short cx;
  short cy;
} DLGTEMPLATE;

Anggota

style

Jenis: DWORD

Gaya kotak dialog. Anggota ini bisa menjadi kombinasi nilai gaya jendela (seperti nilai gaya WS_CAPTION dan WS_SYSMENU) dan kotak dialog (seperti DS_CENTER).

Jika anggota gaya menyertakan gaya DS_SETFONT , header templat kotak dialog berisi data tambahan yang menentukan font yang akan digunakan untuk teks di area klien dan kontrol kotak dialog. Data font dimulai pada batas WORD yang mengikuti array judul. Data font menentukan nilai ukuran titik 16-bit dan string nama font Unicode. Jika memungkinkan, sistem membuat font sesuai dengan nilai yang ditentukan. Kemudian sistem mengirim pesan WM_SETFONT ke kotak dialog dan ke setiap kontrol untuk menyediakan handel ke font. Jika DS_SETFONT tidak ditentukan, templat kotak dialog tidak menyertakan data font.

Gaya DS_SHELLFONT tidak didukung di header DLGTEMPLATE .

dwExtendedStyle

Jenis: DWORD

Gaya yang diperluas untuk jendela. Anggota ini tidak digunakan untuk 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.

cdit

Jenis: WORD

Jumlah item 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, dari 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.

Keterangan

Dalam kotak dialog templat standar, struktur DLGTEMPLATE selalu segera diikuti oleh tiga array panjang variabel yang menentukan menu, kelas, dan judul untuk kotak dialog. Ketika gaya DS_SETFONT ditentukan, array ini juga diikuti oleh nilai 16-bit yang menentukan ukuran titik dan array panjang variabel lain yang menentukan nama typeface. Setiap array terdiri dari satu atau beberapa elemen 16-bit. Menu, kelas, judul, dan array font harus diratakan pada batas WORD .

Segera setelah struktur DLGTEMPLATE adalah array menu yang mengidentifikasi sumber daya menu untuk kotak dialog. Jika elemen pertama dari 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.

Mengikuti array menu adalah array kelas 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 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.

Mengikuti array kelas adalah array judul yang menentukan string Unicode yang dihentikan null yang berisi judul kotak dialog. Jika elemen pertama dari array ini 0x0000, kotak dialog tidak memiliki judul dan array tidak memiliki elemen lain.

Nilai ukuran titik 16-bit dan array typeface mengikuti array judul, tetapi hanya jika anggota gaya menentukan gaya DS_SETFONT. Nilai ukuran titik menentukan ukuran titik font yang akan digunakan untuk teks dalam kotak dialog dan kontrolnya. Array typeface adalah string Unicode null-terminated yang menentukan nama typeface untuk font. Ketika nilai-nilai ini ditentukan, sistem membuat font yang memiliki ukuran dan typeface yang ditentukan (jika memungkinkan) dan mengirim pesan WM_SETFONT ke prosedur kotak dialog dan prosedur jendela kontrol saat membuat kotak dialog dan kontrol.

Mengikuti header DLGTEMPLATE dalam templat kotak dialog standar adalah satu atau beberapa struktur DLGITEMTEMPLATE yang menentukan dimensi dan gaya kontrol dalam kotak dialog. Anggota cdit menentukan jumlah struktur DLGITEMTEMPLATE dalam templat. Struktur DLGITEMTEMPLATE ini harus diselaraskan pada batas DWORD .

Jika Anda menentukan string karakter di menu, kelas, judul, atau array typeface, Anda harus menggunakan string Unicode.

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]
Header	winuser.h (sertakan Windows.h)