SendLevel [v1.1.06+]

Bestimmt, welche künstlichen Tastatur- oder Mausereignisse von Hotkeys und Hotstrings ignoriert werden.

SendLevel, Level

Parameter

Level

Ein Integer zwischen 0 und 100. Kann ein Ausdruck sein.

Allgemeine Bemerkungen

Wenn SendLevel nicht verwendet wird, ist der Level standardmäßig 0.

Hook-Hotkeys und -Hotstrings ignorieren standardmäßig Tastatur- und Mausereignisse, die von einem anderen AutoHotkey-Skript erzeugt werden. In einigen Fällen kann es sinnvoll sein, dieses Verhalten zu überschreiben, z.B. um eine neubelegte Taste andere Hotkeys auslösen zu lassen. SendLevel und #InputLevel stellen dafür die Mittel zur Verfügung.

SendLevel setzt den Level für Ereignisse, die vom aktuellen Skript-Thread erzeugt werden, während #InputLevel den Level für jeden nachfolgenden Hotkey und Hotstring setzt. Damit ein via Skript erzeugtes Ereignis einen Hook-Hotkey oder -Hotstring auslösen kann, muss der Sendlevel des Ereignisses höher sein als der Inputlevel des Hotkeys oder Hotstrings.

Kompatibilität:

• SendPlay wird nicht von SendLevel beeinflusst.
• SendInput wird von SendLevel beeinflusst. Allerdings können die internen Hook-Hotkeys nicht vom Skript aktiviert werden, während ein SendInput aktiv ist, da es den Hook vorübergehend deaktiviert. Wenn Send oder SendInput jedoch auf SendEvent zurückfällt, ist es in der Lage, die Hotkeys des Skripts zu aktivieren.
• Hotkeys, die die reg-Methode verwenden, können nicht zwischen physischen und künstlichen Eingaben unterscheiden und werden daher von SendLevel nicht beeinflusst. Hotkeys über Level 0 verwenden jedoch immer den Tastatur- oder Maus-Hook.
• Hotstrings verwenden #InputLevel nur, um zu bestimmen, ob das zuletzt eingegebene Zeichen einen Hotstring auslösen soll. Zum Beispiel kann der Hotstring ::bzw:: unabhängig von #InputLevel ausgelöst werden, indem bzw mit Level 1 oder höher gesendet und physisch ein Endungszeichen eingegeben wird. Dies liegt an der Funktionsweise der Hotstring-Erkennung, die Eingaben aller Level außer Level 0 in einem einzigen globalen Pufferspeicher sammelt.
• Automatisch-ersetzende Hotstrings erzeugen immer Tastendrücke mit Level 0, da es in der Regel unerwünscht ist, dass der Ersatztext einen anderen Hotstring oder Hotkey auslöst. Um das zu umgehen, verwenden Sie einen nicht-automatisch-ersetzenden Hotstring und den SendEvent-Befehl.
• Zeichen, die mit der ASC-Methode (ALT+nnnnn) gesendet werden, können keinen Hotstring auslösen, selbst wenn SendLevel verwendet wird.
• Zeichen, die mit SendEvent im {Text}-Modus, mit {U+nnnn} oder mit der Unicode-Fallback-Methode gesendet werden, können Hotstrings auslösen.

[v1.1.23+]: Die interne Variable A_SendLevel enthält die aktuelle Einstellung.

Jeder neue Hotkey- oder Hotstring-Thread verwendet vorerst einen Sendlevel, der dem Inputlevel des Hotkeys oder Hotstrings entspricht. Jeder andere neue Thread (z.B. ein Hotkey, ein benutzerdefinierter Menüpunkt oder eine zeitgesteuerte Subroutine) verwendet zunächst die Standardeinstellung des Befehls (üblicherweise 0). Diese Standardeinstellung kann im automatischen Ausführungsbereich geändert werden.

Die Verwendung von SendLevel im automatischen Ausführungsbereich beeinflusst auch die Neubelegung von Tasten.

AutoHotkey-Versionen älter als [v1.1.06] verhalten sich so, als gelte standardmäßig #InputLevel 0 und SendLevel 0.

Siehe auch

#InputLevel, Send, Click, MouseClick, MouseClickDrag

Beispiele

SendLevel 1
SendEvent bzw{Space} ; Erzeugt "beziehungsweise ".

; Folgendes kann in einem anderen Skript definiert werden:
::bzw::beziehungsweise