Funktionreferenz

WinGetText

Beschreibung anzeigen in

Ermittelt den Text eines Fensters.

WinGetText ( "title" [, "text"] )

Parameter

title Der Titel, das Handle oder die Klasse des Fensters, dessen Text erhalten werden soll. Siehe Erweiterte Fenstertiteldefinition.
text [optional] Der Text des Fensters, dessen Text erhalten werden soll. Standardwert ist ein Leerstring. Siehe Erweiterte Fenstertextdefinition.

Rückgabewert

Erfolg: der Text des Fensters als String.
Fehler: "" (Leerstring), wenn das Fenster nicht gefunden wurde.

Bemerkungen

Bis zu 64KB Fenstertext können abgefragt werden. WinGetText() arbeitet auch mit minimierten Fenstern. Zur einwandfreien Arbeit mit versteckten Fenster muss Opt("WinDetectHiddenText", 1) gesetzt sein.

Falls mehrere Fenster das Kriterium für WinGetText() erfüllen, wird der Text des zuletzt aktiven Fensters gelesen.
WinGetText("[active]") gibt den Text des aktiven Fensters zurück.

Verwandte Funktionen

ControlGetText, WinGetClassList, WinGetTitle

Beispiel

#include <MsgBoxConstants.au3>

Example()

Func Example()
    ; Ermittelt den Fenstertext des aktiven Fensters
    Local $sText = WinGetText("[ACTIVE]")

    ; Zeigt den Fenstertext.
    MsgBox($MB_SYSTEMMODAL, "", $sText)
EndFunc   ;==>Example