Win32 API. Структуры и сообщения окна
Страница 28. Сообщение WM_GETTEXTLENGTH

Сообщение WM_GETTEXTLENGTH

Прикладная программа посылает сообщение WM_GETTEXTLENGTH, чтобы определить длину текста, в символах, связанного с окном. Длина не включает символа завершения строки (ноль-терминатора).

Синтаксис

 
WM_GETTEXTLENGTH 
wParam = 0; // не используется, должен быть ноль 
lParam = 0; // не используется, должен быть ноль  

Параметры
У этого сообщения нет параметров.

Возвращаемое значение
Возвращаемое значение - длина текста, в символах.

Действие по умолчанию
Функция DefWindowProc возвращает значение длины текста, в символах. При известных условиях, это значение может фактически быть больше, чем длина текста. Для получения дополнитель-ной информации, см. следующий раздел Замечаний.

Замечания
Для элементов редактирования, текст, который будет скопирован - содержание элементов редактирования. Для комбинированного блока, текст - содержание элементов редактирования (или статический текст) часть комбинированного блока. Для кнопки, текст - имя кнопки. Для других окон, текст - заголовок окна. Чтобы определять длину элемента в окне списка, прикладная программа может использовать сообщение LB_GETTEXTLEN.
При известных условиях, функция DefWindowProc возвращает значение, которое является большим, чем фактическая длина текста. Это происходит с некоторыми смесями ANSI и Уникода, и из-за операционной системы, которая учитывает возможное существование символов DBCS внутри текста. Возвращаемое значение, однако, будет всегда, по крайней мере, такого размера, как факти-ческая длина текста; Вы можете, таким образом, всегда использовать его, чтобы определить распре-деление в буфере. Это поведение может случаться тогда, когда прикладная программа использует и функции ANSI и общие диалоги, которые используют Уникод. LB_GETTEXT, или CB_GETLBTEXT, или функцию GetWindowText.

Смотри также
CB_GETLBTEXT, DefWindowProc, GetWindowText, GetWindowTextLength, LB_GETTEXT, LB_GETTEXTLEN, WM_GETTEXT.

Размещение и совместимость WM_GETTEXTLENGTH

Windows NTДа 
Win95Да 
Win32sДа 
Импортируемая библиотека-
Заголовочный файлwinuser.h 
UnicodeНет 
Замечания по платформеНе имеется