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

ОГЛАВЛЕНИЕ

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