Struktur DLGPAGE (compstui.h)

Struktur DLGPAGE digunakan untuk menentukan halaman lembar properti ke fungsi ComPropSheet CPSUI. Alamat struktur disertakan dalam struktur COMPROPSHEETUI , dan semua nilai anggota disediakan oleh pemanggil ComPropSheet .

Sintaks

typedef struct _DLGPAGE {
  WORD      cbSize;
  WORD      Flags;
  DLGPROC   DlgProc;
  LPTSTR    pTabName;
  ULONG_PTR IconID;
  union {
    WORD   DlgTemplateID;
    HANDLE hDlgTemplate;
  } DUMMYUNIONNAME;
} DLGPAGE, *PDLGPAGE;

Anggota

cbSize

Ukuran yang disediakan penelepon, dalam byte, dari struktur DLGPAGE .

Flags

Bendera bit yang disediakan penelepon, seperti yang dijelaskan dalam tabel berikut.

Bendera	Definisi
DPF_ICONID_AS_HICON	Jika diatur, IconID berisi handel ikon. Jika tidak diatur, IconID berisi pengidentifikasi sumber daya ikon.
DPF_USE_HDLGTEMPLATE	Jika diatur, hDlgTemplate berisi handel templat. Jika tidak diatur, DlgTemplateID berisi pengidentifikasi sumber daya templat.

Penunjuk opsional yang disediakan pemanggil berjenis DLGPROC ke prosedur kotak dialog, digunakan untuk memproses pesan yang dikirim oleh sistem saat peristiwa pengguna terjadi. Jika NULL, CPSUI menyediakan prosedur kotak dialog. Untuk informasi selengkapnya, lihat bagian Keterangan di bawah ini.

DlgProc

Menentukan anggota DLGPROCDlgProc.

pTabName

Penunjuk yang disediakan penelepon ke string yang dihentikan NULL untuk ditampilkan pada tab halaman.

IconID

Penelepon yang disediakan, bisa menjadi salah satu hal berikut:

• Pengidentifikasi sumber daya ikon. Ini dapat ditentukan aplikasi, atau dapat menjadi salah satu pengidentifikasi sumber daya ikon awalan CPSUI yang disediakan IDI_CPSUI.

• Handel ikon. Jika handel ditentukan, DPF_ICONID_AS_HICON harus diatur dalam anggota Bendera .

Ikon yang ditentukan ditampilkan pada tab halaman. Jika nilai ini nol, ikon tidak ditampilkan.

DUMMYUNIONNAME

Mendefinisikan union DUMMYUNIONNAME .

DUMMYUNIONNAME.DlgTemplateID

Pengidentifikasi sumber daya yang disediakan penelepon untuk templat kotak dialog. Ini dapat merujuk ke sumber daya DIALOG yang disediakan aplikasi, atau dapat menjadi salah satu pengidentifikasi yang disediakan CPSUI berikut (didefinisikan dalam compstui.h):

Pengidentifikasi	Tipe halaman
DP_STD_DOCPROPPAGE1	Halaman nontreeview, digunakan untuk halaman Tata Letak dokumen cetak.
DP_STD_DOCPROPPAGE2	Halaman nontreeview, digunakan untuk halaman Kertas/Kualitas dokumen cetak.
DP_STD_TREEVIEWPAGE	Halaman tampilan pohon generik.

Pengidentifikasi yang disediakan CPSUI merujuk ke templat yang dapat menampilkan jenis opsi CPSUI. Ukuran halaman untuk templat tersebut adalah unit kotak dialog 252 kali 216. Untuk informasi selengkapnya, lihat Halaman dan Templat yang Disediakan CPSUI.

Anggota ini tidak digunakan jika DPF_USE_HDLGTEMPLATE diatur dalam Bendera.

DUMMYUNIONNAME.hDlgTemplate

Handel yang disediakan penelepon ke struktur DLGTEMPLATE .

Digunakan hanya jika DPF_USE_HDLGTEMPLATE diatur dalam Bendera.

Keterangan

CPSUI membuat halaman lembar properti dengan mengalokasikan struktur PROPSHEETPAGE dan meneruskannya ke CreatePropertySheetPage. Jika pemanggil telah menentukan penunjuk bertipe DLGPROC ke prosedur kotak dialog di DlgProc, prosedur tersebut digunakan untuk menangani pesan jendela halaman. Jika DlgProc NULL, prosedur kotak dialog CPSUI sendiri digunakan.

Ketika prosedur kotak dialog yang ditunjukkan oleh DlgProc dipanggil dengan nilai pesan WM_INITDIALOG, ia menerima struktur PROPSHEETPAGE sebagai input, dan juga menerima struktur PSPINFO .

Jika prosedur kotak dialog yang disediakan penelepon menangani pesan, prosedur tersebut harus mengembalikan nilai bukan nol. Jika fungsi tidak menangani pesan, fungsi tersebut harus mengembalikan nol, yang menyebabkan CPSUI menangani pesan.

Persyaratan

Persyaratan	Nilai
Header	compstui.h (termasuk Compstui.h)