Ξ
Δ
◄
►
¬
Ѕ
Filter
Direktiven
Interne Variablen
Interne Funktionen
Kontrollanweisungen
Operatoren
Deklarationen
Befehle
Unterbefehle
Interne Methoden/Eigenschaften
Ahk2Exe-Compiler
Suchwörter hervorheben
<script src="../static/ga4.js" type="text/javascript"></script> </head> <body> <h1>StatusBarGetText</h1> <p>Ruft den Text einer regulären Statusleiste ab.</p> <pre class="Syntax"><span class="func">StatusBarGetText</span>, AusgabeVar <span class="optional">, SegmentNummer, FensterTitel, FensterText, AusnahmeTitel, AusnahmeText</span></pre> <h2 id="Parameters">Parameter</h2> <dl> <dt>AusgabeVar</dt> <dd><p>Name der Ausgabevariable, in der der abgerufene Text gespeichert werden soll.</p></dd> <dt>SegmentNummer</dt> <dd><p>Wenn leer oder weggelassen, wird standardmäßig 1 verwendet, was üblicherweise das Segment ist, das den Text von Interesse enthält. Andernfalls geben Sie die Nummer des Leistensegments an, dessen Text abgerufen werden soll. Kann ein <a href="../Variables.htm#Expressions">Ausdruck</a> sein.</p></dd> <dt>FensterTitel, FensterText, AusnahmeTitel, AusnahmeText</dt> <dd> <p>Wenn jeder dieser Parameter leer ist oder weggelassen wird, wird das <a href="../misc/WinTitle.htm#LastFoundWindow">Zuletzt Gefundene Fenster</a> verwendet. Andernfalls geben Sie für <em>FensterTitel</em> einen <a href="../misc/WinTitle.htm">Fenstertitel oder andere Kriterien</a> zur Identifizierung des Zielfensters und/oder für <em>FensterText</em> eine Teilzeichenkette aus einem Textelement des Zielfensters an (Textelemente können mit dem internen Tool "Window Spy" in Erfahrung gebracht werden).</p> <p><em>AusnahmeTitel</em> und <em>AusnahmeText</em> können verwendet werden, um ein oder mehrere Fenster anhand ihres Titels oder Textes auszuschließen. Ihre Angabe ähnelt der von <em>FensterTitel</em> und <em>FensterText</em>, außer dass <em>AusnahmeTitel</em> keine anderen Kriterien als den Fenstertitel erkennt.</p> <p>Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Standardmäßig werden versteckte Fenster nicht erkannt und versteckte Textelemente erkannt, was mit <a href="DetectHiddenWindows.htm">DetectHiddenWindows</a> und <a href="DetectHiddenText.htm">DetectHiddenText</a> geändert werden kann. Standardmäßig muss ein Fenstertitel mit dem angegebenen <em>FensterTitel</em> oder <em>AusnahmeTitel</em> beginnen, um eine Übereinstimmung zu sein, was mit <a href="SetTitleMatchMode.htm">SetTitleMatchMode</a> geändert werden kann.</p> </dd> </dl> <h2 id="Error_Handling">Fehlerbehandlung</h2> <p><span class="ver">[v1.1.04+]</span>: Dieser Befehl ist in der Lage, bei Misserfolg eine Ausnahme auszulösen. Weitere Informationen finden Sie unter <a href="Catch.htm#RuntimeErrors">Laufzeitfehler</a>.</p> <p><a href="../misc/ErrorLevel.htm">ErrorLevel</a> wird bei Misserfolg auf 1 und bei Erfolg auf 0 gesetzt. Bei Misserfolg wird <em>AusgabeVar</em> zudem leer gemacht.</p> <h2 id="Remarks">Bemerkungen</h2> <p>Dieser Befehl versucht, die erste <em>reguläre</em> Statusleiste eines Fensters zu lesen (allgemeines Microsoft-Steuerelement: msctls_statusbar32). Einige Programme verwenden eigene Statusleisten oder spezielle Versionen des MS-Steuerelements - in diesem Fall kann der Text nicht abgerufen werden.</p> <p>Anstatt StatusBarGetText wiederholt mit einer Schleife auszuführen, ist es in der Regel effizienter, <a href="StatusBarWait.htm">StatusBarWait</a> zu verwenden, da es Optimierungen enthält, die den Overhead durch mehrfache Aufrufe von StatusBarGetText vermeiden.</p> <h2 id="Related">Siehe auch</h2> <p><a href="StatusBarWait.htm">StatusBarWait</a>, <a href="WinGetTitle.htm">WinGetTitle</a>, <a href="WinGetText.htm">WinGetText</a>, <a href="ControlGetText.htm">ControlGetText</a></p> <h2 id="Examples">Beispiele</h2> <div class="ex" id="ExBasic"> <p><a class="ex_number" href="#ExBasic"></a> Ermittelt und analysiert den Text des ersten Segments einer Statusleiste.</p> <pre>StatusBarGetText, AbgerufenerText, 1, Suchergebnisse if InStr(AbgerufenerText, "Gefunden") MsgBox, Suchergebnisse wurden gefunden.</pre> </div> </body> </html>