Win32 API. Функции окна
Страница 40. Функция GetWindowTextLength


Функция GetWindowTextLength

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

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

Синтаксис

int GetWindowTextLength
(
HWND hWnd // дескриптор окна или панели управления с текстом
);

Параметры

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

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

Замечания
Эта функция вынуждает послать сообщение WM_GETTEXTLENGTH определяемому окну или элементу управления. При известных условиях, функция GetWindowTextLength может возвращать значение, которое является большим, чем фактическая длина текста. Это происходит с некоторыми смесями ANSI и Unicode и благодаря операционной системе, которая допускает возможное существование символов DBCS внутри текста. Возвращаемое значение, однако, будет всегда, по крайней мере, такого размера, как фактическая длина текста; Вы можете, таким образом, всегда использовать эту функцию, чтобы вести буферное распределение. Это поведение может происходить, когда прикладная программа использует и функции ANSI и общие диалоги, которые использует Unicode. Это может также происходить, когда прикладная программа использует разновидность ANSI GetWindowTextLength с окном, оконная процедура которого - Unicode, или разновидность Unicode с окном, оконная процедура которого - ANSI. Чтобы получить точную длину текста, используйте сообщения WM_GETTEXT, LB_GETTEXT, или CB_GETLBTEXT, или функцию GetWindowText.

Смотри также
CB_GETLBTEXT, GetWindowText, LB_GETTEXT, SetWindowText, WM_GETTEXT, WM_GETTEXTLENGTH

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

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

 

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