#If [AHK_L 4+]

Erstellt kontextabhängige Hotkeys und Hotstrings. Solche Hotkeys führen je nach Ergebnis des Ausdrucks unterschiedliche (oder gar keine) Aktionen durch.

#If Ausdruck

Parameter

Ausdruck

Beliebiger gültiger Ausdruck.

Grundlagen zur Bedienung

Es kann ein beliebiger gültiger Ausdruck verwendet werden, um den Kontext zu definieren, bei dem ein Hotkey aktiv sein soll. Zum Beispiel:

#If WinActive("ahk_class Notepad") or WinActive(MeinFensterTitel)
#Space::MsgBox Sie haben WIN+LEERTASTE im Texteditor oder %MeinFensterTitel% gedrückt.

Die #If-Direktive ist wie die #IfWin-Direktive von der Position abhängig: sie beeinflusst nur Hotkeys und Hotstrings, die sich im Skript physisch darunter befinden. Zudem schließen sich #If und #IfWin gegenseitig aus; das heißt, dass nur das aktuellste #If oder #IfWin wirksam sein wird.

Um die Kontextabhängigkeit zu deaktivieren, geben Sie #If oder eine beliebige #IfWin-Direktive an und lassen Sie alle Parameter weg. Zum Beispiel:

#If

#If kann wie alle anderen Direktiven nicht bedingt ausgeführt werden.

Allgemeine Bemerkungen

Sobald die Tastatur-, Maus- oder Joystick-Tastenkombination eines Hotkeys gedrückt wird, wird der #If-Ausdruck ausgewertet, um zu überprüfen, ob der Hotkey aktiviert werden darf.

Hinweis: Ein Skript sollte nicht davon ausgehen, dass der Ausdruck nur ausgewertet wird, wenn die Taste gedrückt wird (siehe unten).

Der Ausdruck wird eventuell auch ausgewertet, wenn das Programm feststellen muss, ob der Hotkey aktiv ist. Der #If-Ausdruck einer benutzerdefinierten Kombination wie a & b:: beispielsweise wird eventuell ausgewertet, wenn die Präfixtaste (a in diesem Fall) gedrückt wird, um festzustellen, ob sie als benutzerdefinierte Modifikatortaste fungieren soll.

Hinweis: Das Verwenden von #If in einem Skript, das nicht reagiert, kann Eingabeverzögerungen verursachen oder Hotkeys unbrauchbar machen (siehe unten).

Der #If-Direktive sind noch einige weitere Einschränkungen auferlegt:

• Tastatur- oder Mauseingaben werden gepuffert (verzögert), bis die Auswertung des Ausdrucks abgeschlossen ist oder das Zeitlimit überschritten ist.
• Die Auswertung von Ausdrücken wird nicht vom Tastatur-/Maus-Hook, sondern vom Haupt-Thread des Skripts (auf Betriebssystemebene, nicht vom Pseudo-Thread) durchgeführt. Wenn das Skript beschäftigt oder auf nichts reagiert, z. B. wenn FileCopy gerade eine Datei kopiert, wird die Auswertung des Ausdrucks verzögert oder im schlimmsten Fall verworfen, weil das Zeitlimit überschritten wurde.
• Wenn das systemdefinierte Zeitlimit überschritten wurde, kann es vorkommen, dass das System aufhört, dem Skript Tastatur- oder Mauseingaben mitzuteilen (siehe #IfTimeout, um mehr zu erfahren).
• Das Senden von Tastendrücken oder Mausklicks während der Auswertung des Ausdrucks (z. B. mit einer Funktion, die sie selbst aufruft) kann zu Komplikationen führen und sollte vermieden werden.

[AHK_L 53+]: Das Setzen von A_ThisHotkey und A_TimeSinceThisHotkey basiert auf den Hotkey, den der aktuelle #If-Ausdruck ausgewertet hat.

[v1.0.95.00+]: A_PriorHotkey und A_TimeSincePriorHotkey enthalten vorübergehend die vorherigen Werte der entsprechenden "This"-Variablen.

Siehe auch

Die meisten Verhaltensmuster der #IfWin-Direktiven gelten auch für #If.

Mit #IfTimeout kann der Standardwert des Zeitlimits überschrieben werden.

Beispiele

#If MausIstÜber("ahk_class Shell_TrayWnd")
WheelUp::Send {Volume_Up}
WheelDown::Send {Volume_Down}

MausIstÜber(FensterTitel) {
    MouseGetPos,,, Fenster
    return WinExist(FensterTitel . " ahk_id " . Fenster)
}

#If AktivesSteuerelementIstKlasse("Edit")
^BS::Send ^+{Left}{Del}
^Del::Send ^+{Right}{Del}

AktivesSteuerelementIstKlasse(Klasse) {
    ControlGetFocus, FokussiertesStrlmnt, A
    ControlGet, FokussiertesStrlmntHwnd, Hwnd,, %FokussiertesStrlmnt%, A
    WinGetClass, FokussiertesStrlmntKlasse, ahk_id %FokussiertesStrlmntHwnd%
    return (FokussiertesStrlmntKlasse=Klasse)
}

#If
Esc::ExitApp

NumpadAdd::
Hotkey, If, MausIstÜber("ahk_class Shell_TrayWnd")
if (zweimalhoch := !zweimalhoch)
    Hotkey, WheelUp, ZweimalHoch
else
    Hotkey, WheelUp, WheelUp
return

ZweimalHoch:
Send {Volume_Up 2}
return