PROPENUMPROCEXW 回调函数 (winuser.h)

应用程序定义的回调函数与 EnumPropsEx 函数一起使用。 该函数从窗口的属性列表中接收属性条目。 PROPENUMPROCEX 类型定义指向此回调函数的指针。 PropEnumProcEx 是应用程序定义的函数名称的占位符。

语法

PROPENUMPROCEXW Propenumprocexw;

BOOL Propenumprocexw(
  HWND unnamedParam1,
  LPWSTR unnamedParam2,
  HANDLE unnamedParam3,
  ULONG_PTR unnamedParam4
)
{...}

参数

unnamedParam1

类型:HWND

要枚举其属性列表的窗口的句柄。 此参数通常命名为 hWnd

unnamedParam2

类型: LPWSTR

属性列表条目的字符串组件。 这是通过调用 SetProp 函数将属性添加到窗口属性列表时指定的字符串以及数据句柄。 此参数通常命名为 lpString

unnamedParam3

类型:HANDLE

数据的句柄。 此句柄是属性列表项的数据组件。 此参数通常命名为 hData

unnamedParam4

类型:ULONG_PTR

应用程序定义的数据。 这是指定为调用 EnumPropsEx 发起枚举的 lParam 参数的值。 此参数通常命名为 dwData

返回值

类型:BOOL

返回 TRUE 以继续属性列表枚举。

返回 FALSE 以停止属性列表枚举。

言论

注意

参数在标头中定义,没有名称: typedef BOOL (CALLBACK* PROPENUMPROCEXW)(HWND, LPWSTR, HANDLE, ULONG_PTR);。 因此,语法块将它们 unnamedParam1 - unnamedParam4列为 。 可以在应用中命名这些参数。 但是,它们通常按参数说明中所示命名。

以下限制适用于此回调函数:

  • 回调函数可以调用 RemoveProp 函数。 但是,RemoveProp 只能删除通过回调函数的参数传递给回调函数的属性。
  • 回调函数不应尝试添加属性。

注意

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

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 winuser.h (包括 Windows.h)

另请参阅

概念

窗口属性

参考

EnumPropsEx

RemoveProp

SetProp