На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

GetWindowTextLength



The GetWindowTextLength function retrieves the length, in characters, of the specified window's title bar text (if the window has a title bar). If the specified window is a control, the function retrieves the length of the text within the control.

int GetWindowTextLength(

HWND hWnd // handle of window or control with text
);


Parameters

hWnd

Identifies the window or control.



Return Values

If the function succeeds, the return value is the length, in characters, of the text. Under certain conditions, this value may actually be greater than the length of the text. For more information, see the following Remarks section.
If the window has no text, the return value is zero. To get extended error information, call GetLastError.

Remarks

This function causes a WM_GETTEXTLENGTH message to be sent to the specified window or control.
Under certain conditions, the GetWindowTextLength function may return a value that is larger than the actual length of the text. This occurs with certain mixtures of ANSI and Unicode, and is due to the operating system allowing for the possible existence of DBCS characters within the text. The return value, however, will always be at least as large as the actual length of the text; you can thus always use it to guide buffer allocation. This behavior can occur when an application uses both ANSI functions and common dialogs, which use Unicode. It can also occur when an application uses the ANSI flavor of GetWindowTextLength with a window whose window procedure is Unicode, or the Unicode flavor with a window whose window procedure is ANSI.

To obtain the exact length of the text, use the WM_GETTEXT, LB_GETTEXT, or CB_GETLBTEXT messages, or the GetWindowText function.

See Also

CB_GETLBTEXT, GetWindowText, LB_GETTEXT, SetWindowText, WM_GETTEXT, WM_GETTEXTLENGTH


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

GetWindowTextLength



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

int GetWindowTextLength(

РУЧКА HWND hWnd // окна или управления с текстом
);


Параметры

hWnd

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



Обратные Величины

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

Замечания

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

Для того, чтобы получать точную длину текста, используйте WM_GETTEXT, LB_GETTEXT, или сообщения CB_GETLBTEXT, или функция GetWindowText.

Смотри Также

CB_GETLBTEXT, GetWindowText, LB_GETTEXT, SetWindowText, WM_GETTEXT, WM_GETTEXTLENGTH


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz