GetWindowTextLength

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

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

Параметры

hWnd
Дескриптор окна или элемента управления.

Возвращаемые значения

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

Если окно имеет текст не, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Примечания

Если целевое окно принадлежит текущим процессом, GetWindowTextLength вызывает WM_GETTEXTLENGTH сообщения изображения для указанного окна или элемента управления.

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

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

QuickInfo

nbsp; Windows &NT: требует версии 3.1 или более поздней версии.
Windows:Требует Windows 95 или более поздней версии.
Windows CE:Требует версии 1.0 или более поздней версии.
Заголовок:Объявленные в winuser.h.
Импорта библиотеки:Используйте user32.lib.
Юникод:В версии Юникода и ANSI в Windows NT.

Родственные слова

Обзор Windows, функции окна, CB_GETLBTEXT, GetWindowText, LB_GETTEXT, SetWindowText, WM_GETTEXT, WM_GETTEXTLENGTH

Index