LPFNPSPCALLBACKA 回调函数 (prsht.h)

指定属性表在创建页面和即将销毁页面时调用的应用程序定义的回调函数。应用程序可以使用此函数对页面执行初始化和清理操作。

语法

LPFNPSPCALLBACKA Lpfnpspcallbacka;

UINT Lpfnpspcallbacka(
            HWND hwnd,
  [in]      UINT uMsg,
  [in, out] _PROPSHEETPAGEA *ppsp
)
{...}

hwnd

类型： HWND

保留;必须为 NULL。

[in] uMsg

类型： UINT

操作标志。此参数的取值可为下列值之一：

值	含义
PSPCB_ADDREF	版本 5.80 或更高版本。正在创建一个页面。不使用返回值。
PSPCB_CREATE	正在为页面创建一个对话框。返回非零值以允许创建它，或返回零以阻止它。
PSPCB_RELEASE	正在销毁页面。返回值将被忽略。

[in, out] ppsp

类型： LPPROPSHEETPAGE

指向 PROPSHEETPAGE 结构的指针，该结构定义要创建或销毁的页面。有关进一步讨论，请参阅备注部分。

类型： UINT

返回值取决于 uMsg 参数的值。

应用程序必须在 PROPSHEETPAGE 结构的 pfnCallback 成员中指定此回调函数的地址，然后才能将该结构传递给 CreatePropertySheetPage 函数。

注意调用此函数时，属性表正在操作页面列表。处理此通知时，请勿尝试添加、删除或插入页面。这样做会产生不可预知的结果。

除了 lParam 成员，应用程序不应修改 PROPSHEETPAGE 结构。这样做会产生不可预知的结果。 lParam 成员包含应用程序定义的数据，可以根据需要进行修改。

注意

prsht.h 标头将 LPFNPSPCALLBACK 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。