SendLevel

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

SendLevel Level

Parameter

Level

Typ: Integer

Ein Integer zwischen 0 und 100.

Rückgabewert

Typ: Integer

Diese Funktion gibt die vorherige Einstellung zurück; ein Integer zwischen 0 und 100.

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 die SendEvent-Funktion.
• 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.

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 der Funktion (üblicherweise 0). Diese Standardeinstellung kann während der Startphase des Skripts geändert werden.

Die Verwendung von SendLevel während der Startphase des Skripts 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