EM_GETHANDLE消息

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

参数

wParam

未使用;必须为零。

lParam

未使用;必须为零。

返回值

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

备注

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

注意

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

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

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

要求

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

另请参阅

引用

EM_SETHANDLE

其他资源

GetWindowText

GetWindowTextLength

LocalLock

LocalUnlock