Win32 API. Функции окна
Страница 39. Функция GetWindowText


Функция 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
UnicodeWinNT
Замечания по платформеНе имеется

 
« Предыдущая статья   Следующая статья »