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 参数的值。

言论

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

注意 调用此函数时,属性表正在操作页面列表。 处理此通知时,请勿尝试添加、删除或插入页面。 这样做将产生不可预知的结果。
 
除了 lParam 成员之外,应用程序不应修改 PROPSHEETPAGE 结构。 这样做将产生不可预知的结果。 lParam 成员包含应用程序定义的数据,并且可以根据需要进行修改。

注意

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

要求

要求 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 prsht.h