GetWindowText

Die GetWindowText -Funktion kopiert den Text der Titelleiste des angegebenen Fensters (sofern vorhanden) in einen Puffer. Wenn das angegebene Fenster ein Steuerelement ist, wird der Text des Steuerelements kopiert. Jedoch, GetWindowText den Text eines Steuerelements in einer anderen Anwendung abrufen kann nicht.

Int GetWindowText) HWND  hWnd, / / handle für Fenster oder Steuerelement mit TextLPTSTRlpString, / / Adresse des Puffers für TextintnMaxCount / / maximale Anzahl der zu kopierenden Zeichen);
 

Parameter

hWnd

Handle für das Fenster oder Steuerelement mit dem text.

lpString

Zeiger auf den Puffer, der den Text erhalten.

nMaxCount

Gibt die maximale Anzahl von Zeichen in den Puffer, einschließlich des NULL-Zeichens zu kopieren. Wenn der Text dieses Limit überschreitet, wird es abgeschnitten.

Rückgabewerte

Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Länge in Zeichen, der kopierten Zeichenfolge, nicht einschließlich des abschließenden Nullzeichens. Wenn das Fenster hat keine Titelleiste oder Text, wenn die Titelleiste leer ist, oder wenn das Fenster oder Steuerelement Handle ungültig ist, ist der Rückgabewert 0 (null). Rufen Sie Fehlerinformationen verlängert bekommen, GetLastError.

Diese Funktion kann nicht den Text der ein Edit-Steuerelement in einer anderen Anwendung abzurufen.

Bemerkungen

Wenn das Zielfenster durch den aktuellen Prozess gehört, bewirkt GetWindowText eine WM_GETTEXT Nachricht an das angegebene Fenster oder Steuerelement gesendet werden. Wenn das Zielfenster eine Beschriftung hat und ist im Besitz von einem anderen Prozess, ruft GetWindowText den Fenster Beschriftungstext. Wenn das Fenster nicht über eine Beschriftung verfügt, ist der Rückgabewert eine null-Zeichenfolge.

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, GetWindowTextLength, SetWindowText, WM_GETTEXT

Index