StatusBarGetText

Ermittelt den Text einer Standard-Statusleiste.

StatusBarGetText, AusgabeVar , SegmentNummer, FensterTitel, FensterText, IgnoriereTitel, IgnoriereText

Parameter

AusgabeVar

Name der Ausgabevariable, in der der abgerufene Text gespeichert werden soll.

SegmentNummer

Die Nummer des Leistenbereichs, dessen Text abgerufen werden soll (kann auch ein Ausdruck sein). Wenn dieser Parameter leer ist, wird standardmäßig 1 verwendet (der erste Bereich enthält üblicherweise den interessanten Text).

FensterTitel

Der Titel oder andere Möglichkeiten zum Identifizieren des Zielfensters. Weitere Informationen finden Sie unter FensterTitel-Parameter.

FensterText

Eine Zeichenkette, die in einem der Textelemente des Zielfensters enthalten ist (eventuell vorhandene Textelemente können mit dem internen Tool Window Spy aufgedeckt werden). Versteckte Textelemente werden nur erkannt, wenn DetectHiddenText eingeschaltet ist.

IgnoriereTitel

Alle Fenster, die diesen Wert in ihren Titeln enthalten, werden ignoriert.

IgnoriereText

Alle Fenster, die diesen Wert in ihren Textelementen enthalten, werden ignoriert.

Fehlerbehandlung

[v1.1.04+]: Dieser Befehl ist in der Lage, bei Misserfolg eine Ausnahme auszulösen. Weitere Informationen finden Sie unter Laufzeitfehler.

ErrorLevel wird bei Misserfolg auf 1 und bei Erfolg auf 0 gesetzt. Bei Problemen wird AusgabeVar zudem leer gemacht.

Bemerkungen

Dieser Befehl versucht, die erste Standard-Statusleiste eines Fensters zu lesen (typisches Steuerelement von Microsoft: msctls_statusbar32). Einige Programme verwenden ihre eigenen Statusleisten oder spezielle Versionen des Microsoft-Steuerelements - in diesem Fall kann der Text nicht abgerufen werden.

Anstatt diesen Befehl in einer Schleife zu verwenden, ist es besser, StatusBarWait zu verwenden, weil es Optimierungen beinhaltet, die einen Overhead durch mehrfaches Aufrufen von StatusBarGetText verhindern.

Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Versteckte Fenster werden nur erkannt, wenn DetectHiddenWindows eingeschaltet ist.

StatusBarWait, WinGetTitle, WinGetText, ControlGetText

Beispiele

Ermittelt und analysiert den Text im ersten Segment einer Statusleiste.

StatusBarGetText, AbgerufenerText, 1, Suchergebnisse
if InStr(AbgerufenerText, "Gefunden")
    MsgBox, Suchergebnisse wurden gefunden.