GetWindowTextLength

GetWindowTextLength функція отримує довжини, символи, з вікна вказаний текст (якщо вікно має рядок заголовка). Якщо вікно вказаного елемента керування, функція повертає довжину тексту всередині елемента керування. Однак, GetWindowTextLength не вдалося отримати довжина текстового поля в іншому додатку.

int GetWindowTextLength ( HWND  hWnd / / ручка вікна або керування з текстом);
 

Параметри

hWnd
Ручка вікна або керування.

Повернення значень

Якщо функція завершено успішно, значення, що повертається є довжина, символи тексту. За певних умов це значення може бути насправді більше довжини тексту. Докладніше перегляньте наступний розділ зауваження.

Якщо вікно не містить тексту, значення дорівнює нулю. Щоб отримати докладні відомості про помилку, зателефонуйте GetLastError.

Зауваження

Якщо вікно цільового належить поточний процес, GetWindowTextLength викликає WM_GETTEXTLENGTH повідомлення буде відправлено до вказаного вікна або елемента керування.

За певних умов GetWindowTextLength функція може повертати значення, яке перевищує фактичної довжини тексту. Це відбувається з певних сумішей ANSI та Юнікод і завдяки система, що дозволяє для можливості існування Двобайтовий знаків у тексті. Значення, яке повертається, проте, завжди буде як великий, як фактичні довжину тексту; Таким чином завжди можна це керівництво буфер розподілу. Це може статися, коли застосунок використовує функції ANSI та загальні діалогові вікна, які використовують Unicode. Вона може також виникати, коли застосунок використовує ANSI версії GetWindowTextLength з вікна, чиї вікно процедура є Юнікод, або Unicode версії GetWindowTextLength з вікна, чиї вікно процедура є ANSI. Докладніше про функції ANSI та Unicode, перегляньте То прототипи функцій 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