capture screen
画面をキャプチャし、画像ファイルとして保存します。
名前 | 説明 | タイプ | 修飾子 |
---|---|---|---|
window | (任意)ウィンドウのTA名です。 | Interface Entity | なし |
control | (任意)コントロールのTA名です。 | Interface Element | なし |
left | (任意)アクティブなUI要素(引数 window と control の値の有無によって、ウィンドウ、コントロール、または画面全体である)の左端からの相対的な、矩形領域(rect エリアと呼ばれる)の左境界を指定する。この矩形領域とアクティブなUI要素の組み合わせがアクティブエリアを決定する。ベースライン画像との一致をスキャンするのはこのエリアに限られます。(単位: ピクセル) デフォルト値: 0 | String | なし |
top | (任意)アクティブな UI 要素の上端からの相対的な、rect エリアの上端ボーダーを指定します。 (単位: ピクセル) デフォルト値: 0 | String | なし |
width | (任意)矩形領域の幅を指定します。(単位: ピクセル) デフォルト値: アクティブUI要素の幅 | String | なし |
height | (任意)矩形領域の高さを指定します。(単位: ピクセル) デフォルト値: アクティブなUI要素の高さ | String | なし |
image location | 画像を保存するファイルのフルパスです。 | String | なし |
なし
このアクションは、次のプロジェクト項目で使用できます: テストモジュールおよびユーザー定義アクションです。
window control left top width height image location
capture screen 車両を見る 車の写真 D:\images\toyota_prius.bmp
- キャプチャした画像は、.JPEG、.BMP、または.PNGとしてのみ保存できます。ファイル名 部分に希望の拡張子を含めます。
- このアクションは、キャプチャされたビットマップのうち、アクティブエリアとして特定された部分に適用され、画像の残りの部分は無視されます。アクティブエリアは、引数 window, control
そして矩形領域を定義する4つの引数(left, top, width, height)の組み合わせによって決定されます。
最初に window と control は、次のルールに基づいて、アクティブなUI要素を決定します。このUI要素は、コントロール、ウィンドウ、またはフルスクリーンのいずれかです。
アクティブなUI要素が設定された場合、任意の rect エリアは、指定された場合、アクティブなUI要素の左上隅に対する矩形領域を指定します(4つの引数 rect のいずれも指定されていない場合、アクティブエリアはアクティブなUI要素そのものです)。引数 window 引数 control アクティブなUI要素 省略 省略 画面全体(全体のキャプチャされたテスト画像) 指定 省略 アプリケーションウィンドウ全体 指定 指定 指定されたコントロール
上記の図は、引数 window, control が指定され、アクティブなUI要素として12台の車を持つ画像コントロールが設定された場合に適用されるアクティブエリアを示しています。rectエリアを指定する値(left, top, width, height)は、アクティブなUI要素の一部とその外部の領域をカバーするように設定されています。この場合、アクティブエリアはアクティブなUI要素と rect エリアの重複領域です。 - ほとんどの場合、指定された rect エリア場合は、その境界がアクティブなUI要素内にある断面領域を定義し、rect エリア自体がアクティブエリアである。しかし、必ずしもそのような場合ばかりではありません。以下の3つの画像は、rect エリアが指定された場合にアクティブエリアがどのように決定される一般的なケースを示しています。
アクティブエリアを決定する一般的なルールは以下のように表示されます:rect エリア: 結果のアクティブエリア: 指定されていない場合 アクティブなUI要素 アクティブなUI要素と重なる場合 交点空間(上記のケース1と2) アクティブなUI要素と重ならない場合 アクティブなUI要素(上記のケース3) - Windows プラットフォーム: パスの区切り文字にはスラッシュを使用します。
- Linux プラットフォーム: パスの区切りにはスラッシュを使用します。(ネットワーク・パスはサポートされていないことに注意してください)
- このアクションは修飾子 <ignore> をサポートしています。引数のいずれかの値として文字列
<ignore>
が含まれているか、或いはどの引数かが<ignore>
に評価される式を含んでいる場合、そのアクションは実行中にスキップされます。