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

Written on . Posted in Win32

ОГЛАВЛЕНИЕ

Страница 28 из 56

Сообщение 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    Нет 
Замечания по платформе  Не имеется

c++ форум