struktur PROPSHEETUI_INFO (compstui.h)

Struktur PROPSHEETUI_INFO digunakan sebagai parameter input untuk fungsi berjenis PFNPROPSHEETUI.

Sintaks

typedef struct _PROPSHEETUI_INFO {
  WORD            cbSize;
  WORD            Version;
  WORD            Flags;
  WORD            Reason;
  HANDLE          hComPropSheet;
  PFNCOMPROPSHEET pfnComPropSheet;
  LPARAM          lParamInit;
  ULONG_PTR       UserData;
  ULONG_PTR       Result;
} PROPSHEETUI_INFO, *PPROPSHEETUI_INFO;

Anggota

cbSize

Ukuran yang disediakan CPSUI, dalam byte, dari struktur PROPSHEETUI_INFO .

Version

Nomor versi yang disediakan CPSUI dari struktur PROPSHEETUI_INFO . Nomor versi saat ini ditentukan oleh PROPSHEETUI_INFO_VERSION dalam compstui.h.

Flags

Bendera bit yang disediakan CPSUI. Bendera berikut didefinisikan:

Bendera Deskripsi
PSUIINFO_UNICODE Jika diatur, aplikasi panggilan menggunakan karakter Unicode.

Reason

Konstanta yang disediakan CPSUI yang menentukan tindakan yang akan dilakukan pada lembar properti oleh fungsi jenis PFNPROPSHEETUI tempat struktur PROPSHEETUI_INFO diteruskan. Salah satu konstanta berikut akan disediakan:

  • PROPSHEETUI_REASON_DESTROY

  • PROPSHEETUI_REASON_GET_ICON

  • PROPSHEETUI_REASON_GET_INFO_HEADER

  • PROPSHEETUI_REASON_INIT

  • PROPSHEETUI_REASON_SET_RESULT

Untuk informasi tentang arti setiap konstanta, lihat bagian Keterangan dari deskripsi PFNPROPSHEETUI .

hComPropSheet

Handel yang disediakan CPSUI ke induk grup lembar properti. Handel ini dapat diteruskan ke fungsi ComPropSheet CPSUI.

pfnComPropSheet

Alamat fungsi ComPropSheet CPSUI.

lParamInit

Nilai yang diterima sebagai parameter lParam untuk fungsi berjenis PFNPROPSHEETUI terkait, ketika fungsi pertama kali dipanggil dengan Alasan PROPSHEETUI_REASON_INIT. Untuk informasi tentang nilai ini, lihat deskripsi PFNPROPSHEETUI.

Nilai ini disediakan oleh CPSUI, dan berlaku untuk semua nilai Alasan .

UserData

Opsional, nilai privat, atau pointer yang disediakan oleh fungsi berjenis PFNPROPSHEETUI terkait, awalnya diatur ke nol oleh CPSUI. Jika fungsi menyimpan nilai di UserData, maka untuk panggilan berikutnya ke fungsi, nilai atau penunjuk yang disimpan tidak berubah kecuali diubah oleh fungsi.

Result

Nilai hasil yang disediakan oleh fungsi berjenis PFNPROPSHEETUI terkait, awalnya diatur ke nol oleh CPSUI. Jika fungsi menyimpan nilai hasil dalam Hasil, maka untuk panggilan berikutnya ke fungsi, nilai yang disimpan tidak berubah kecuali diubah oleh fungsi.

Jika alamat fungsi yang diketik PFNPROPSHEETUI ditentukan sebagai argumen ke CommonPropertySheetUI, nilai terakhir yang disimpan dalam Hasil dikembalikan ke CommonPropertySheetUI di lokasi yang ditunjukkan oleh argumen pResult-nya .

Persyaratan

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