EM_GETHANDLE消息

获取当前为多行编辑控件的文本分配的内存的句柄。

参数

wParam

未使用;必须为零。

lParam

未使用;必须为零。

返回值

返回值是标识保存编辑控件内容的缓冲区的内存句柄。 如果发生错误(例如将消息发送到单行编辑控件),则返回值为零。

备注

如果函数成功,应用程序可以通过将返回值强制转换为 HLOCAL 并将其传递给 LocalLock 来访问编辑控件的内容。 LocalLock 返回指向缓冲区的指针,该缓冲区是 CHARWCHAR的以 null 结尾的数组,具体取决于 ANSI 或 Unicode 函数是否创建了控件。 例如,如果使用 CreateWindowExA ,则缓冲区是 CHAR的数组,但如果使用的是 CreateWindowExW ,则缓冲区是 WCHAR的数组。 应用程序不得更改缓冲区的内容。 为了解锁缓冲区,应用程序在允许编辑控件接收新消息之前调用 LocalUnlock

注意

对于Comctl32.dll版本 6,缓冲区始终包含 WCHAR的数组,无论 ANSI 函数还是 Unicode 函数创建了编辑控件。 有关 DLL 版本的详细信息,请参阅 通用控件版本

如果应用程序无法遵守 EM_GETHANDLE 施加的限制,请使用 GetWindowTextLengthGetWindowText 函数将编辑控件的内容复制到应用程序提供的缓冲区中。

Rich Edit: 不支持 EM_GETHANDLE 消息。 丰富编辑控件不会将文本存储为简单的字符数组。

要求

要求
最低受支持的客户端
Windows Vista [仅限桌面应用]
最低受支持的服务器
Windows Server 2003 [仅限桌面应用]
标头
Winuser.h (包括 Windows.h)

另请参阅

引用

EM_SETHANDLE

其他资源

GetWindowText

GetWindowTextLength

LocalLock

LocalUnlock