WM_GETTEXTLENGTH сообщение

  • Статья

Определяет длину (в символах) текста, связанного с окном.

#define WM_GETTEXTLENGTH                0x000E

Параметры

wParam

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

lParam

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

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

Тип: LRESULT

Возвращаемое значение — это длина текста в символах, не включая завершающий символ NULL.

Комментарии

Для элемента управления редактированием копируемый текст — это содержимое элемента управления редактирования. Для поля со списком текст — это содержимое элемента управления редактированием (или статического текста) поля со списком. Для кнопки текстом является имя кнопки. Для других окон текстом является заголовок окна. Чтобы определить длину элемента в списке, приложение может использовать LB_GETTEXTLEN сообщение.

При отправке сообщения WM_GETTEXTLENGTH функция DefWindowProc возвращает длину текста в символах. При определенных условиях функция DefWindowProc возвращает значение, превышающее фактическую длину текста. Это происходит с определенными сочетаниями ANSI и Юникода и связано с тем, что система допускает возможное существование двухбайтовых символов (DBCS) в тексте. Однако возвращаемое значение всегда будет по меньшей мере равно фактической длине текста; Таким образом, вы всегда можете использовать его для распределения буфера. Это может произойти, когда приложение использует как функции ANSI, так и общие диалоги, использующие Юникод.

Чтобы получить точную длину текста, используйте сообщения WM_GETTEXT, LB_GETTEXT или CB_GETLBTEXT или функцию GetWindowText .

Отправка сообщения WM_GETTEXTLENGTH в нетекстовый статический элемент управления, например статическое растровое изображение или статический значок controlc, не возвращает строковое значение. Вместо этого возвращается ноль.

Требования

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

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

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

DefWindowProc

GetWindowText

GetWindowTextLength

WM_GETTEXT

Основные понятия

Windows

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

CB_GETLBTEXT

LB_GETTEXT

LB_GETTEXTLEN