GetWindowTextLength

Funkcja GetWindowTextLength pobiera długość, w znaki, tekst paska tytułu określonego okna (jeśli okno zawiera pasek tytułu). Jeśli określonego okna jest formantem, funkcja pobiera długość tekstu w formancie. Jednak GetWindowTextLength nie można pobrać długość tekstu formant edycyjny w innej aplikacji.

int GetWindowTextLength ( HWND  hWnd / dojście do okna lub sterowania tekstem);
 

Parametry

hWnd
Dojście do okna lub kontroli.

Zwraca wartości

Jeśli funkcja, wartość zwracany jest długością w znaków tekstu. Pod pewnymi warunkami wartość ta rzeczywiście może być większa niż długość tekstu. Aby uzyskać więcej informacji zobacz następującą sekcję Uwagi.

Jeśli okno jest żaden tekst, wartość zwracany jest równa zero. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError.

Uwagi

Jeśli okno docelowe jest własnością bieżącego procesu, GetWindowTextLength powoduje, że wiadomość WM_GETTEXTLENGTH do wysłania do określonego okna lub formantu.

Pod pewnymi warunkami funkcja GetWindowTextLength może zwrócić wartość, która jest większa niż faktyczna długość tekstu. Występuje w niektórych mieszanek ANSI lub Unicode i wynika z systemu, pozwalając na ewentualne istnienie znaków Dwubajtowych znaków w tekście. Wartość zwracany, jednak zawsze będzie co najmniej tak duży, jak rzeczywista długość tekstu; tak więc zawsze można go przewodnik alokacji buforów. To zachowanie może wystąpić, gdy aplikacja używa funkcji ANSI i wspólnych okien dialogowych, które używają Unicode. Ponadto może wystąpić, gdy aplikacja używa wersji ANSI GetWindowTextLength z okna, w których procedura okno jest wersji Unicode GetWindowTextLength z okna, w których procedura okno jest ANSI lub Unicode. Aby uzyskać więcej informacji na temat funkcji ANSI i Unicode, zobacz Prototypy funkcji Win32.

Aby uzyskać dokładną długość tekstu, użyć wiadomości WM_GETTEXT, LB_GETTEXTlub CB_GETLBTEXT lub funkcji GetWindowText.

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Wymaga wersja 1.0 lub nowsza.
Nagłówka:Zadeklarowane w pliku winuser.h.
Importowanie biblioteki:Należy użyć user32.lib.
Unicode:Implementowane jako wersje Unicode i ANSI w systemie Windows NT.

Zobacz też

Omówienie Windows, okno funkcji, CB_GETLBTEXT, GetWindowText, LB_GETTEXT, SetWindowText, WM_GETTEXT, WM_GETTEXTLENGTH

Index