SendLevel

ホットキーやホットストリングで、どの人工的なキーボードやマウスイベントを無視するかを制御します。

SendLevel Level

パラメータ

Level

型：整数

0～100の整数値です。

戻り値

型：整数

This function returns the previous setting; an integer between 0 and 100.

総論

If SendLevel is not used, the default level is 0.

デフォルトでは、フックホットキーと ホットストリングは、AutoHotkeyスクリプトによって生成されたキーボードとマウスイベントを無視します。例えば、リマップキーを使って他のホットキーをトリガーできるようにするなど、この動作をオーバーライドすると便利な場合があります。SendLevelと#InputLevelは、そのための手段を提供します。

SendLevelは現在のスクリプトスレッドが生成するイベントのレベルを設定し、#InputLevelはその下にあるホットキーやホットストリングのレベルを設定します。スクリプトによって生成されたイベントがフックのホットキーやホットストリングをトリガーするためには、イベントの送信レベルがホットキーやホットストリングの入力レベルよりも高くなければなりません。

Compatibility:

• SendPlayはSendLevelの影響を受けません。
• SendInputは、SendLevelの影響を受けますが、SendInputの実行中はフックを一時的に無効化するため、スクリプト独自のフックホットキーを起動することはできません。しかし、SendやSendInputがSendEventに戻ると、スクリプト自身のホットキーを有効にすることができます。
• Hotkeys using the "reg" method are incapable of distinguishing physical and artificial input, so are not affected by SendLevel. ただし、レベル0以上のホットキーは、常にキーボードまたはマウスフックを使用します。
• ホットストリングは、最後に入力された文字がホットストリングをトリガーするかどうかを判断するために#InputLevelのみを使用します。例えば、レベル1以上でbtwを送信し、終了文字を物理的に入力することで、#InputLevelに関係なくホットストリング::btw::をトリガーすることができます。これは、ホットストリング認識が、レベル0を除くすべてのレベルからの入力を単一のグローバルバッファに集めることで機能するためです。
• 自動置換ホットストリングは、通常、置換テキストが他のホットストリングやホットキーをトリガーすることは望ましくないので、常にレベル0のキーストロークを生成します。これを回避するには、自動置換されないホットストリングとSendEvent関数を使用します。
• ASC（Alt+nnnn）メソッドで送信された文字は、SendLevelが使用されていても、ホットストリングをトリガーすることはできません。
• SendEventで{Text}モード、{U+nnnn}またはUnicode fallbackメソッドで送信された文字は、ホットストリングをトリガーすることができます。

内蔵変数A_SendLevelには、現在の設定値が格納されます。

新しく起動したホットキーやホットストリングのスレッドは、ホットキーやホットストリングの入力レベルに等しい送信レベルで始まります。その他の新しく起動するスレッド（カスタムメニュー項目や 時間指定サブルーチンなど）は、通常0ですが、スクリプト起動時にこの関数を使用して変更することができるデフォルト設定で新たに開始されます。

スクリプト起動時にSendLevelを使用した場合、キーボードとマウスのリマッピングにも影響します。

v1.1.06より古いバージョンのAutoHotkeyは、#InputLevel 0と SendLevel 0が有効であるかのように動作します。

関連

#InputLevel, Send, Click, MouseClick, MouseClickDrag

例

SendLevel 1
SendEvent "btw{Space}" ; Produces "by the way ".

; This may be defined in a separate script:
::btw::by the way