PROPSHEETUI_INFO 结构 (compstui.h)
PROPSHEETUI_INFO 结构用作 PFNPROPSHEETUI 类型函数的输入参数。
语法
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;
成员
cbSize
PROPSHEETUI_INFO 结构的 CPSUI 提供的大小(以字节为单位)。
Version
CPSUI 提供的 PROPSHEETUI_INFO 结构的版本号。 当前版本号由 compstui.h 中的 PROPSHEETUI_INFO_VERSION 定义。
Flags
CPSUI 提供的位标志。 定义了以下标志:
标志 | 描述 |
---|---|
PSUIINFO_UNICODE | 如果设置,调用应用程序将使用 Unicode 字符。 |
Reason
CPSUI 提供的常量,指定要由传递PROPSHEETUI_INFO结构的 PFNPROPSHEETUI 类型函数对属性表执行的操作。 将提供以下常量之一:
PROPSHEETUI_REASON_DESTROY
PROPSHEETUI_REASON_GET_ICON
PROPSHEETUI_REASON_GET_INFO_HEADER
PROPSHEETUI_REASON_INIT
PROPSHEETUI_REASON_SET_RESULT
有关每个常量的含义的信息,请参阅 PFNPROPSHEETUI 说明的“备注”部分。
hComPropSheet
属性表 组父级提供的 CPSUI 句柄。 此句柄可以传递给 CPSUI 的 ComPropSheet 函数。
pfnComPropSheet
CPSUI 的 ComPropSheet 函数的地址。
lParamInit
当第一次调用函数时,作为关联的 PFNPROPSHEETUI 类型函数的 lParam 参数接收的值, 其原因 为 PROPSHEETUI_REASON_INIT。 有关此值可以是什么的信息,请参阅 PFNPROPSHEETUI 的说明。
此值由 CPSUI 提供,对所有 Reason 值都有效。
UserData
可选的私有值或指针,由关联的 PFNPROPSHEETUI 类型函数提供,最初由 CPSUI 设置为零。 如果函数在 UserData 中存储值,则对于函数的后续调用,除非函数更改,否则存储的值或指针保持不变。
Result
由关联的 PFNPROPSHEETUI 类型函数提供的结果值,最初由 CPSUI 设置为零。 如果函数将结果值存储在 Result 中,则对于函数的后续调用,除非函数更改,否则存储的值将保持不变。
如果将 PFNPROPSHEETUI 类型函数的地址指定为 CommonPropertySheetUI 的参数,则存储在 Result 中的最后一个值将返回到其 pResult 参数指向的位置中的 CommonPropertySheetUI。
要求
要求 | 值 |
---|---|
Header | compstui.h (包括 Compstui.h) |