SetProp函数添加一个新条目或更改指定窗口的属性列表中的现有条目。如果列表中不存在指定的字符串,该函数将向列表中添加一个新条目。新条目包含字符串和句柄。否则,该函数将使用指定的句柄替换字符串的当前句柄。
BOOL SetProp(
HWND 【的hWnd】, | //窗口的句柄 |
LPCTSTR 【lpString】, | //原子或字符串的地址 |
HANDLE 【HDATA】 | //处理数据 |
); |
参数
【的hWnd】
标识属性列表接收到新条目的窗口。
【lpString】
指向一个空值终止的字符串或包含一个标识字符串的原子。如果这个参数是一个原子,它必须是由前一次调用GlobalAddAtom函数创建的全局原子。原子,一个16位的值必须放在【lpString】的低位字中。高阶字必须为零。
【HDATA】
标识要复制到属性列表的数据。数据句柄可以识别对应用程序有用的任何值。
返回值
如果数据句柄和字符串被添加到属性列表中,则返回值不为零。
如果函数失败,返回值为零。
备注
在销毁窗口之前(即在处理WM_DESTROY消息之前),应用程序必须删除其添加到属性列表中的所有条目。应用程序必须使用RemoveProp功能删除条目。
也可以看看