GetWindowTextLength

Die GetWindowTextLength -Funktion Ruft die Länge in Zeichen für das angegebene Fenster Text der Titelleiste (wenn das Fenster eine Titelleiste verfügt). Wenn das angegebene Fenster ein Steuerelement handelt, ruft die Funktion die Länge des Texts im Steuerelement ab. Jedoch kann nicht GetWindowTextLength die Länge des Textes ein Edit-Steuerelement in einer anderen Anwendung abzurufen.

Int GetWindowTextLength) HWND  hWnd / / handle für Fenster oder Steuerelement mit Text);
 

Parameter

hWnd
Handle für das Fenster oder Steuerelement.

Rückgabewerte

Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Länge in Zeichen des Textes. Unter bestimmten Bedingungen kann dieser Wert tatsächlich größer als die Länge des Textes sein. Weitere Informationen finden Sie unter den folgenden Abschnitt "Hinweise".

Wenn das Fenster keinen Text enthält, ist der Rückgabewert 0 (null). Rufen Sie Fehlerinformationen verlängert bekommen, GetLastError.

Bemerkungen

Wenn das Zielfenster durch den aktuellen Prozess gehört, bewirkt, dass GetWindowTextLength eine WM_GETTEXTLENGTH -Nachricht an das angegebene Fenster oder Steuerelement gesendet werden soll.

Unter bestimmten Bedingungen kann die GetWindowTextLength -Funktion einen Wert zurückgeben, der größer als die tatsächliche Länge des Textes ist. Dies tritt bei bestimmten Mischungen von ANSI und Unicode und ist das System für die mögliche Existenz von DBCS-Zeichen innerhalb des Textes. Der Rückgabewert wird jedoch immer mindestens so groß wie die tatsächliche Länge des Textes sein; Somit können immer es Sie Pufferzuordnung führen. Dieses Verhalten kann auftreten, wenn eine Anwendung sowohl ANSI-Funktionen und Dialogfelder, die Unicode verwenden. Es kann auch auftreten, wenn eine Anwendung die ANSI-Version der GetWindowTextLength mit einem Fenster dessen Fensterprozedur ist Unicode oder Unicode-Version der GetWindowTextLength mit einem Fenster, dessen Fensterprozedur ANSI ist. Weitere Informationen zu ANSI- und Unicode-Funktionen finden Sie unter Win32 Funktionsprototypen.

Verwenden Sie, um die genaue Länge des Textes zu erhalten, WM_GETTEXT, LB_GETTEXToder CB_GETLBTEXT Nachrichten oder der GetWindowText -Funktion.

QuickInfo

&Nbsp; Windows NT: Version 3.1 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Version 1.0 oder höher benötigt.
Header:In winuser.h deklarierten.
Importieren Bibliothek:Verwenden Sie user32.lib.
Unicode:Als Unicode und ANSI-Versionen unter Windows NT implementiert.

Siehe auch

Übersicht über Windows, Fensterfunktionen, CB_GETLBTEXT, GetWindowText, LB_GETTEXT, SetWindowText, WM_GETTEXT, WM_GETTEXTLENGTH

Index