Image Collections

4.1.1 Image Collections

画像コレクションは、通常、1つのグラフィカルオブジェクトの様々な視覚的外観または可能な状態（例えば、様々な環境および/またはオペレーティングシステム上のボタン）をキャプチャした画像を表します。コレクションはCompareto, Screenshot そしてWaitFor match/mismatchスクリプト言語コマンドまたは対応するJavaメソッドにより、あらゆる環境で画面上のコンポーネントをシームレスに見つけることができます。

T-Plan Robot バージョン 2.0 以降では、 セミコロンで区切られた画像ファイルリストによる画像コレクションをサポートしています。例えば、テンプレートフォルダにある 2 つのテンプレート画像 buttonOK1.png と buttonOK2.png で表される「OK」ボタンを検索するには、次のようにします。：

JS

Compareto "buttonOK1.png;buttonOK2.png" method=search

T-Plan Robotバージョン2.2では、フォルダで表現される動的な画像コレクションを導入しました。このメカニズムにより、スクリプトコードを更新することなく、テンプレート画像を動的に追加、削除、編集することができます。各フォルダはJavaがサポートするロスレス形式の画像（PNG、BMP、WBMP、GIF）を再帰的に検索し、生成された画像リストに対して指定された画像比較アクションを実行します。

たとえば、前の例の画像を buttonOK というフォルダーに移動し、コマンドを次のように変更できます。：

JS

Compareto "buttonOK" method=search

フォルダから取得された画像は、デフォルトでは、基本的なオペレーティングシステムによって返される自然な順序で処理されます。バージョン2.3.3では、この動作を変更し、比較の前に画像を並べ替えることを可能にする新しいオプション機構が導入されました：

デフォルトのソートモードを設定するには、 「設定」ウィンドウの「CompareToコマンド」 パネルを参照してください。この設定は、次の項目で説明するようにスクリプトによってソートモードが上書きされない限り、アプリケーション全体に適用されます。
スクリプトは_compareto_sort_mode。変数を希望するソートモードのインデックスを設定することで、ソートモードを設定できます。この変数はスイッチとして機能し、この変数がリセットされるかスクリプトの末尾に到達するまで、すべての比較コマンドでこのソートモードが適用されます。使用可能な値は次のとおりです。：

0 - 画像ファイル名でソート（昇順）
1 - 画像ファイル名でソート（降順）
2 - 画像ファイルの最終更新日でソート（昇順）
3 - 画像ファイルの最終更新日でソート（降順）

例えたとえば、前の例の画像をファイル名の降順 (buttonOK2.png 最初) で処理するには、次を使用します。：

JS

Var _COMPARETO_SORT_MODE=1
Compareto "buttonOK" method=search

並べ替えモードをデフォルトにリセットするには、変数を空の文字列に設定するだけです。：

JS

Var _COMPARETO_SORT_MODE=

画像コレクションは、画像と画像コレクションからなるファイルリストに自由に組み合わせることができます。例えば、画像と buttonApprove1.png 画像で表現される「OK」ボタンまたは「承認」ボタンを検索するにはbuttonApprove2.png 、次のようにします。：

JS

Compareto "buttonOK;buttonApprove1.png;buttonApprove2.png" method=search

あるいは２つの画像用のフォルダーを作成して、 buttonApprove で次のように記述することもできます。

JS

Compareto "buttonOK;buttonApprove" method=search