1.27.3.15 Сообщение WM_GETTEXT

Прикладная программа посылает сообщение WM_GETTEXT, чтобы копировать текст, который соответствует тексту в окне буфера, которым обеспечена вызывающая программа.

Синтаксис

WM_GETTEXT  
wParam = (WPARAM) cchTextMax;   	// число копируемых символов
lParam = (LPARAM) lpszText;         // адрес буфера для текста 

Параметры

cchTextMax
Значение wParam. Устанавливает максимальное число символов, которое будет скопировано, включая символ завершения ноль-терминатор.
lpszText
Значение lParam. Указывает на буфер, который должен принять текст.

Возвращаемые значения
Возвращаемое значение - скопированное число символов.

Действие по умолчанию
Функция DefWindowProc копирует текст, связанный с окном в заданный буфер и возвращает скопированное число символов.

Замечания
Для элемента редактирования, текст, который будет скопирован - содержит элементы редактирования. Для комбинированного поля, текст - содержание элементов редактирования (или статический текст) часть комбинированного поля. Для кнопки, текст - имя кнопки. Для других окон, текст - заголовок окна. Чтобы копировать текст элемента в окне списка, прикладная программа может использовать сообщение LB_GETTEXT.
Когда сообщение WM_GETTEXT посылается статическому элементу управления со стилем SS_ICON, дескриптор пиктограммы будет возвращен в первых четырех байтах буфера указателя lpszText. Это истинно только тогда, если сообщение WM_SETTEXT использовалось, чтобы установить пиктограмму.

В мощных средствах редактирования, если текст, который будет скопирован, превышает 64КБ, используется сообщение или EM_STREAMOUT или EM_GETSELTEXT.

Смотри также
DefWindowProc, EM_GETSELTEXT, EM_STREAMOUT, GetWindowText, GetWindowTextLength, LB_GETTEXT, WM_GETTEXTLENGTH, WM_SETTEXT

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

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

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