Ξ
Δ
◄
►
¬
Ѕ
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>Throw <span class="ver">[v1.1.04+]</span></h1> <p>Signalisiert das Vorkommen eines Fehlers. Dieses Signal kann mit einer <a href="Try.htm">Try</a>-<a href="Catch.htm">Catch</a>-Anweisung abgefangen werden.</p> <pre class="Syntax"><span class="func">Throw</span> <span class="optional">, Ausdruck</span></pre> <h2 id="Parameters">Parameter</h2> <dl> <dt>Ausdruck</dt> <dd><p><span class="ver">[v1.1.05+]</span>: Wenn weggelassen, wird ein <a href="#Exception">Exception-Objekt</a> mit einer Standardmeldung ausgelöst.</p> <p>Andernfalls geben Sie einen Wert an, der in die Ausgabevariable von <a href="Catch.htm">Catch</a> gespeichert werden soll.</p> <p>Da dieser Parameter ein <a href="../Variables.htm#Expressions">Ausdruck</a> ist, sind alle der folgenden Zeilen gültig:</p> <pre>throw 3 throw "direkt geschriebene Zeichenkette" throw MeineVar throw i + 1 throw { what: "Benutzerdefinierter Fehler", file: A_LineFile, line: A_LineNumber } <em>; Übergibt ein <a href="Object.htm">Objekt</a></em></pre> <p>Dieser Parameter ist immer ein Ausdruck, daher sollten Variablenreferenzen nur mit <a href="../FAQ.htm#percent">Prozentzeichen</a> umschlossen werden, wenn eine <a href="../Variables.htm#ref">Doppeldereferenz</a> (double-deref) beabsichtigt ist.</p> </dd> </dl> <h2 id="Exception">Exception()</h2> <p>Erstellt ein Objekt mit Eigenschaften, die auch für via <a href="Catch.htm#RuntimeErrors">Laufzeitfehler</a> erzeugte Ausnahmen üblich sind.</p> <pre class="Syntax"><span class="func">Exception</span>(Message <span class="optional">, What, Extra</span>)</pre> <p>Dieses Objekt enthält die folgenden Eigenschaften:</p> <ul> <li><strong>Message:</strong> Eine Fehlermeldung oder ein <a href="../misc/ErrorLevel.htm">ErrorLevel</a>-Wert.</li> <li><strong>What:</strong> Der Name des Befehls, der Funktion oder des Labels, der/die/das zum Zeitpunkt des Auftretens des Fehlers ausgeführt wurde oder kurz davor stand.</li> <li><strong>Extra:</strong> Zusätzliche Informationen über den Fehler, falls verfügbar.</li> <li><strong>File:</strong> Der vollständige Pfad der Skriptdatei, die die Zeile enthält, in der der Fehler auftrat.</li> <li><strong>Line:</strong> Die Nummer der Zeile, in der der Fehler auftrat.</li> </ul> <p>Wenn <em>What</em> weggelassen wird, wird standardmäßig der Name der aktuellen Funktion oder Subroutine verwendet. Andernfalls geben Sie eine Zeichenkette oder einen negativen Offset vom Anfang der Aufrufliste an. Zum Beispiel bewirkt -1, dass <code>Exception.What</code> auf die aktuelle Funktion oder Subroutine gesetzt wird, und dass <code>Exception.Line</code> und <code>Exception.File</code> auf die Zeile und Datei gesetzt wird, die die Funktion oder Subroutine aufgerufen hat. Wenn das Skript jedoch <a href="../Scripts.htm#ahk2exe">kompiliert</a> ist oder der Offset ungültig ist, wird <em>What</em> einfach in eine Zeichenkette umgewandelt.</p> <p><em>Message</em> und <em>Extra</em> werden in Zeichenketten umgewandelt. Diese werden in einem Fehlerdialogfenster angezeigt, wenn die Ausnahme ausgelöst, aber nicht abgefangen wurde.</p> <pre>try EineFunktion() catch e MsgBox % "Fehler in " e.What ", das auf Zeile " e.Line " aufgerufen wurde." EineFunktion() { throw Exception("Fehler", -1) }</pre> <h2 id="Related">Siehe auch</h2> <p><a href="Try.htm">Try</a>, <a href="Catch.htm">Catch</a>, <a href="Finally.htm">Finally</a>, <a href="OnError.htm">OnError()</a></p> <h2 id="Examples">Beispiele</h2> <p>Siehe <a href="Try.htm#Examples">Try</a>.</p> </body> </html>