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

Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Владимир Соковиков - 15.12.2001