Поделиться через

сообщение EM_GETHANDLE

  • Статья

Возвращает дескриптор памяти, выделенной для текста многострочного элемента управления редактированием.

Параметры

wParam

Не используется; значение должно быть равно нулю.

lParam

Не используется; значение должно быть равно нулю.

Возвращаемое значение

Возвращаемое значение — это дескриптор памяти, определяющий буфер, содержащий содержимое элемента управления редактированием. Если возникает ошибка, например при отправке сообщения в однострочный элемент управления редактированием, возвращаемое значение равно нулю.

Комментарии

Если функция выполнена успешно, приложение может получить доступ к содержимому элемента управления редактированием, приведения возвращаемого значения к HLOCAL и передав его в LocalLock. LocalLock возвращает указатель на буфер, который является массивом символов CHARили WCHAR, которые завершаются нулевым значением, в зависимости от того, создала ли элемент управления функция ANSI или Юникод. Например, если использовалось CreateWindowExA , буфер представляет собой массив символов CHAR, а если использовался CreateWindowExW , буфер представляет собой массив WCHAR. Приложение не может изменять содержимое буфера. Чтобы разблокировать буфер, приложение вызывает LocalUnlock , прежде чем разрешить элементу управления редактированием получать новые сообщения.

Примечание

Для Comctl32.dll версии 6 буфер всегда содержит массив WCHAR, независимо от того, создала ли функция ANSI или Юникод элемент управления редактированием. Дополнительные сведения о версиях DLL см. в разделе Common Control Versions.

Если приложение не может соблюдать ограничения, накладываемые EM_GETHANDLE, используйте функции GetWindowTextLength и GetWindowText , чтобы скопировать содержимое элемента управления редактированием в предоставленный приложением буфер.

Расширенное редактирование: Сообщение EM_GETHANDLE не поддерживается. Элементы управления форматированным редактированием не хранят текст в виде простого массива символов.

Требования

Требование Значение
Минимальная версия клиента
 Windows Vista [только классические приложения]
Минимальная версия сервера
 Windows Server 2003 [только классические приложения]
Заголовок
Winuser.h (включая Windows.h)

См. также раздел

Справочные материалы

EM_SETHANDLE

Другие ресурсы

GetWindowText

GetWindowTextLength

LocalLock

LocalUnlock