1.27.1.34 Функция GetWindowText

(ПолучитьТекстОкна)

Функция GetWindowText копирует текст строки заголовка определяемого окна (если оно имеет ее) в буфер. Если определяемое окно - элемент управления, текст элемента управления копируется.

Синтаксис

int GetWindowText
(
HWND hWnd,		// дескриптор окна или элемента управления с текстом
LPTSTR lpString,		// адрес буфера для текста
int nMaxCount 		// максимальное число символов для копирования
);

Параметры

hWnd
Идентифицирует окно или элемент управления, содержащее текст

lpString
Указывает на буфер, который примет текст.

nMaxCount
Устанавливает максимальное число символов для копирования в буфер. Если текст превышает это ограничение, он усекается.

Возвращаемые значения
Если функция завершается успешно, возвращаемое значение - длина, в символах, скопированной строки, не, включая символа конца строки (ноль-терминатора). Если у окна нет никакой строки заголовка или текста, если строка заголовка пустая или, если дескриптор окна или элемента управления недопустимы, возвращаемое значение нулевое. Чтобы получать расширенные данные об ошибках, вызовите GetLastError. Эта функция не может отыскать текст элемента для редактирования в другой прикладной программе.

Замечания
Эта функция заставляет послать сообщение WM_GETTEXT определяемому окну или элементу управления. Эта функция не может возвращать текст элемента для редактирования в другую прикладную программу.

Смотри также
GetWindowTextLength,SetWindowText, WM_GETTEXT

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

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

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