Mouse (JA)

3.1.6 マウス

説明

Mouse - マウス・イベントを実行する。このコマンドは、マウス・ポインタの移動、マウス・クリック、マウス・プレス、マウス・リリース、ドラッグ、マウス・ホイール・イベントなど、さまざまなマウス・アクションを自動化することができる。このコマンドは、マウス押下、マウス移動、マウスリリースイベントのシーケンスで構成されるカスタムドラッグにも対応しています(2.0.2以降)。構成されたイベント（クリック、ドラッグ）が失敗する場合は、マウスコマンドの環境設定でキャリブレーションパラメータを確認してください。

現在のマウスポインタの座標は、スクリプトの_MOUSE_X and _MOUSE_Y dynamic variables(バージョン2.1以降)を通して利用できます。

SYNOPSIS

mouse [<modifier_1>+...+<modifier_N>+] <event_id> [btn=<button_name>] [modifiers=<modifier_1>+...+<modifier_N>] [to=[x:<x>][,y:<y>]] [from=[x:<x>][,y:<y>]] [center=[x:<x>][,y:<y>]] [start=<number>] [end=<number] [count=<number>] [wait=<time>]

* 赤色は必須パラメーターを示す。

オプション

modifier

-Shift、Alt、Ctrlをプラス「+」記号で区切った任意の組み合わせ。

event_id

-サポートされるイベント

- "move"、任意の移動先からターゲットポイントへのマウスポインタの移動、
- "click"、指定されたマウスボタンを使用したターゲットポイントでの1回以上のクリック、
- "press"、マウスボタンの押下（リリースなし）、
- "release"、マウスボタンのリリース（論理的には、その前に押下イベントが必要）、
- 「ドラッグ(drag)": 指定されたマウスボタンを使って、任意の移動先からターゲットポイントまでマウスをドラッグする、
- 「スワイプ(swipe)」、タッチディスプレイを持つデバイス(AndroidやiOSデバイスなど)のためにタイミングを調整したマウスドラッグ、
- 「ホイールアップ(wheelup)"、1つまたは複数のマウスホイールの回転ステップを上向きにする(ホイールがユーザーから離れる方向に回転する)、
- 「ホイールダウン(wheeldown)"、1つまたは複数のマウスホイールの回転ステップを下向きにする(ホイールがユーザーに向かって回転する)、
- "pinch"、2本の指がタッチスクリーン上で共有された中心点に向かって移動する1つ以上のピンチイベント（"pinch close "とも呼ばれる）。このイベントは特定の環境でのみサポートされています。ios接続タイプ、
- "zoom"、2本の指がタッチスクリーン上の共有中心点から離れる1つ以上のズームイベント（"pinch open "とも呼ばれる）。このイベントは特定の環境でのみサポートされています。ios 接続タイプで接続されている T-Plan Server を実行している Apple iOS デバイスなどでサポートされています。

btn

-このパラメータは、クリック、プレス、リリース、またはドラッグするマウスボタンを識別するために使用されます。許可される値は"left"、"middle"、"right "です。

修飾子

-このパラメータは、マウスイベントの修飾子を指定する別の方法を提供する（もう1つの方法は、イベントIDの前に修飾子を置くことである）。値はShift、Alt、Ctrlの任意の組み合わせで、「Ctrl+Alt+Shift」のようにプラス「+」記号で区切って指定します。修飾子がイベント ID と一緒に指定されている場合は、このパラメータが優先されます。

to=[x:<x>][,y:<y>]

-ターゲット座標。

- イベントが "move "の場合、マウスポインタの移動先（ターゲットポイント）を定義する。
- イベントが "click"、"press"、"release"、"wheelup"、または "wheeldown "の場合、マウスポインタはまずこの位置に移動され、関連するアクションが実行されます。
- アクションが "drag "または "swipe "の場合、マウスポインタは実際の位置から(またはfromオプションで指定された位置から)このターゲット位置までドラッグされる。

座標は'x:<x>,y:<y>' の書式を持ち、各座標はピクセル単位（例えば'x:225'）またはパーセント単位（例えば'x:23%'）で指定できます。x または y が省略された場合、現在のマウスポインタの位置が不足する座標の決定に使用されます。

from=[x:<x>][,y:<y>]

-開始座標。

アクションが"drag "または"swipe "の場合、マウスポインタはこの位置からtoオプションで指定された座標までドラッグされます。
イベントが"click"、"press"、"release"、"wheelup"、"wheeldown "の場合、このパラメータは無視されます。

座標は'x:<x>,y:<y>' の書式を持ち、各座標はピクセルで指定するか（'x:225'など）、パーセンテージで相対的に指定します（'x:23.5%'など）。相対座標が整数でない場合は丸められます。x または y が省略された場合、現在のマウスポインタの位置が不足する座標の決定に使用されます。

center=[x:<x>][,y:<y>]

-ピンチ/ズームの中心点(オプション)。ピンチ」および「ズーム」アクションにのみ使用されます。パラメータが省略された場合、アクションのデフォルトは画面中央になります。

座標は'x:<x>,y:<y>'の形式で、ピクセル単位（'x:225'など）または相対座標（'x:23.5%'など）で指定します。相対座標が整数でない場合は丸められます。x または y が省略された場合、現在のマウスポインタの位置が不足する座標の決定に使用されます。

start=<number> end=<number>

-ピンチ/ズームの開始距離と終了距離。pinch" と "zoom" アクションにのみ使用されます。パラメータは常に一緒に指定する必要があります。省略した場合、アクションは中心点の位置と現在のスクリーンサイズに基づいてデフォルト値を計算します。

距離は、ジェスチャーの開始時（"start"）と終了時（"end"）に指が何ピクセル離れているかを指定します。
イベントが "pinch "の場合、指が互いに近づくため、開始時の距離は終了時の距離よりも当然大きくなければなりません。
ズーム "イベントの場合は逆の設定が必要です。距離は、指が互いに近づきすぎないように（最低でも 30 ピクセル）、または画面の境界線に 10 ピクセル以上近づかないように指定する必要があります。

count=<数値>

-マウスイベントを何回実行するか。デフォルト値は1。この値はclick、wheel、pinch、zoomイベントでのみ意味を持ち、他のイベントタイプでは無視される。

wait=<time>

-イベント送信後の待ち時間。以下のコマンドが'Wait <time>' であった場合と同じ効果を持つ。値はミリ秒数か有効な値でなければならない。Time Values.デフォルト値は0（待機しない）である。スクリプトは、"Var _MOUSE_WAIT=1s" のように、_MOUSE_WAIT変数に希望する遅延時間を代入してデフォルト値を設定することができます。

RETURNS
コマンドは成功すると0（ゼロ）を返し、I/Oエラーなどで失敗すると1を返す。

例
Mouse click count=2

- 現在のマウスポインタ座標でマウスをダブルクリックする。

Mouse move to=x:25,y:122

- マウスポインタを指定された座標に移動する。

Mouse move to=x:{_MOUSE_X}+50

- マウスポインタを現在の位置から右に50ピクセル移動する。

Mouse drag from=x:10%,y:450 to=x:22.5%,y:450 wait=2s

- マウスポインタを指定された開始位置から目的位置までドラッグし、2秒間待ちます。x座標は相対形式で指定します。ディスプレイの解像度が例えば800x600ピクセルの場合、'x:10%'は'x:60'に、'x:22.5%'は'x:135'になります。

Mouse swipe from=x:161,y:124 to=x:161,y:226

- タッチスクリーンを開始位置から目的位置までスワイプする。

Compareto "icon.png" method=search onfail="Exit 1"
Mouse move to=x:{_SEARCH_X}+10,y:{_SEARCH_Y}+10
Mouse press
Mouse move to=x:{_SEARCH_X}+110 wait=500
Mouse release

{画像比較によって位置が特定されたオブジェクトに適用される「合成ドラッグ」の例。スクリプトはまず、icon.png テンプレートで表されたオブジェクトをデスクトップから探します。見つかったら、マウスポインタをその領域（各方向にプラス10ピクセル）に移動させ、押下、移動、リリースイベントのシーケンスを使ってオブジェクトを右に100ピクセルドラッグします。

Mouse pinch

- 画面をピンチする。現在の接続がピンチをサポートしている場合、現在のアプリケーションがズームアウトされます。

Mouse zoom center=x:220,y:450 start=125 end=180

- 画面を拡大します。現在の接続がピンチに対応している場合、現在のアプリケーションを拡大表示します。このコマンドは、カスタム中心点と開始距離と終了距離を使用します。