Moveto

3.2.13 MoveTo

説明

Click コマンドと同様に、MoveTo は Waitfor matchとMouse moveコマンドの組み合わせです。コンポーネント画像、ソリッドカラーオブジェクト、またはテキストをデスクトップから探し、マウスポインタをそこに移動させます。オブジェクトが見つからない場合はスクリプトを終了します。

SYNOPSIS

MoveTo <comparison_method> [timeout=<time>] [cmparea=<[x:<x>][,y:<y>][,w:<width>][,h：<height>]>] [number=<component_number>] [modifiers=<modifiers>] [wait=<time>][<メソッ<method specific options>]。

赤色は必須パラメーターを示します

comparison_method

-サポートされているメソッドは以下の通り：

'image' - コンポーネントを画像もしくはimage collectionsメソッドを使ってsearch2メソッドを使用します、
'object' - メソッドを使って色でコンポーネントを検索します。objectメソッドを使用します、
'ocr' - OCR（メソッド）を使って画面上のテキストを認識し、指定された文字列またはパターンを検索します。tocrメソッド）を使用して画面上のテキストを認識し、指定された文字列またはパターンを検索します。

共通オプション

timeout=<時間>

-タイムアウトは、コンポーネントが画面に表示されるまでの最大待ち時間を指定します。値は数ミリ秒または有効なTime Valuesでなければなりません。デフォルトは30秒です。

cmparea=[x:<x>][,y:<y>][,w:<width>][,h:<height>]

-比較を制限するためにデスクトップの長方形の領域を制限します。。このパラメータを省略すると、リモートデスクトップ全体が処理されます。領域の座標は「x:<x>,y:<y>,w:<width>,h:<height>」の形式で、各座標はピクセル単位（たとえば「x:225」）またはパーセント単位（「x:23%」）で指定できます。x、y、width、heightのいずれかが省略された場合、アプリはフルスクリーンの値を使用して不足するパラメータを決定します（x:0、y:0、w:<screen_width>、h:<screen_height>）。

number=<コンポーネント番号>

– マウスを移動させる画面上のコンポーネントの番号。画面上のコンポーネント(オブジェクト)は、上から下、左から右の読み順にソートされます。デフォルト値は1（最初にあるコンポーネントをクリック）です。画面上で見つかったコンポーネントの数が指定された数より少ない場合、コマンドはスクリプトを終了します。

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

-ターゲットオブジェクトの中心からの相対的な移動位置を指定します。これにより、オブジェクトそのものではなく、近くの位置にマウスを移動させることができます。比較メソッドがイメージの場合、このパラメータはイメージを上書きしクリックポイントを上書きし、画像の中心を基点として使用します。例えば、"MoveTo image template=button.png move=x:-40 "のコマンドは、ポインタをボタンの中心から左に40ピクセル移動させます。

modifiers=<修飾子>

-マウスイベント修飾子（オプション）。値はShift、Alt、Ctrlの任意の組み合わせで、プラス「+」記号で区切ります。

continue=<数字>

-trueの値では、オブジェクトが見つからなければスクリプトは終了しません。デフォルト値はfalse（失敗時に終了）です。コマンドはまた、_MOVETO_CONNECT変数の値を監視し、それをデフォルト値として使用します。たとえば、スクリプト内のすべてのMoveToコマンドをデフォルトで終了しないようにするには、最初にこの変数をtrueに設定します("Var _MOVETO_CONTINUE=true")。

step=<ステップ名>

-コマンドとのシンプルな統合Stepコマンドとのシンプルな統合。指定されると、指定された名前のテストステップを作成し、結果は合格（オブジェクトが見つかり、マウスポインタがそのオブジェクトに移動した）または不合格（オブジェクトが見つからなかった）です。

wait=<時間>

-移動が完了するまでの待ち時間。これは、次のコマンドが「Wait <time_in_ms>」であった場合と同じ効果を持ｖちます。値はミリ秒数か有効な値でなければなりません。time value.デフォルト値は0（待機しない）です。スクリプトは、「Var _MOVETO_WAIT=1s」のように、_MOVETO_WAIT変数に希望する遅延を入力してデフォルト値を設定することができます。

Moveto image template=<image_collection> [passrate=<pass_rate_in_%>] [<search2_specific_params>] [<common_options>]。

赤色は必須パラメーターを示します

特定のオプション - image

template=<image_collection>

-画像image collections- リモートデスクトップイメージと比較する 1 つ以上のイメージファイル名、またはイメージをセミコロン (';') で区切ったフォルダ。Linux/Unix では、ファイル名にセミコロンが含まれていないと、リストが正しく解析されません。ファイル名には、相対パス（img.png など）または絶対パス（/root/report/img.png など）を指定できます。相対パスを使った場合、画像は_TEMPLATE_DIR_ variable.サポートされる画像フォーマットは、Javaのバージョンに依存します。Java 1.6では、少なくともPNG、JPG、GIF、BMPをサポートしています。

テンプレート画像は、指定されたリストの順序でリモートデスクトップ画像と比較されます。テンプレートの比較で肯定的な結果（指定されたイベントに応じて、一致または不一致のいずれか）が得られた場合、条件は満たされたとみなされ、コマンドは終了コード0で終了し、リスト内の残りのテンプレートをスキップします。定義済み変数 _COMPARETO_TEMPLATE_INDEX は、マッチするテンプレート画像のインデックスを決定するために使われます。対応する変数の一覧は画像比較固有の変数を参照してください。

passrate=<pass_rate_in%>

-画像比較の通過率。0から100の間の数値を指定する必要があり、その後にパーセンテージを指定することもできます（例："passrate=95 "または "passrate=95%"）。このパラメータが省略された場合、デフォルトのsearch2通過率50%が使用されます。

search2_specific_params

-比較メソッドでサポートされる任意のパラメータ。search2 比較メソッドでサポートされる任意のパラメータ（オプション）。

Moveto object [<object_specific_options>] [<common_options>]

特定のオプション - オブジェクト

object_specific_params

-オブジェクト比較メソッドでサポートされるパラメータ（オプション）。通常、少なくともオブジェクトの色を指定する必要があります。

Moveto ocr [<Text OCR ("tocr")>] [<common_options>].

特定のオプション - ocr

tocr_specific_options

-比較メソッドでサポートされる Text OCR ("tocr")比較メソッドでサポートされる任意のパラメータ。text またはpattern オプションで移動先のテキストを指定する必要があります。

戻り値

コマンドは、成功すると常に0を返し、失敗すると指定された比較メソッドからのエラーコードを返してスクリプトを終了します。

例

JS

Moveto image template="google_button.png"number="2"

画面上のgoogle_button.png画像で指定された2番目のボタンの中央に移動します。ボタンが見つからないか、画面上のボタンの数が2より少ない場合、コマンドはスクリプトを失敗させます。

JS

Moveto object tolerance="10" color="255;0;0" max="w:20"

幅が20ピクセル以下の赤いオブジェクトを見つけ、マウス・ポインタをその中心に移動させます。トレランスは、メソッドがより多くの赤の色合いを見つけることを保証します。

JS

Moveto ocr text="Cancel" distance="1"

OCRを使って画面上のテキストを読み、"Cancel "の最初の単語に移動します。この距離により、OCRエンジンが1つの文字、たとえば「Cencel」などを省略したり認識できなかったりしても、その単語が確実に見つかります。