check text exists
指定されたビットマップの特定の領域内に、与えられた
が存在するかを確認します。
名前 | 説明 | タイプ | 修飾子 |
---|---|---|---|
window | ウィンドウのTA名です。 | Interface Entity | なし |
control | コントロールのTA名です。 | Interface Element | なし |
rect | (任意)rectエリアの寸法を指定します。これは、引数 window, control によって決定されたアクティブなUI要素と組み合わせて、アクティブエリアを定義します。検索テキスト(textで定義)のスキャンは、このアクティブエリアに制限されます(詳細は
を参照してください)。rectエリアの位置を指定する値は、アクティブなUI要素に対して相対的です。
| String | なし |
text | 検索する を表す文字列です。 | String | なし |
index | (任意)検索テキストの最小出現回数を指定し、対象の が見つかったとみなされるためには、アクティブエリア内で発見される必要があります。 デフォルト値: 1 | String | なし |
text color | (任意)テキストのカラーコード、16進数表記です。(詳細は を参照してください) この値はOCR検出ツール ダイアログボックスから取得されます。 | String | なし |
結果は、テキストが見つかった場合、「Passed」になり、それ以外の場合は「Failed」になります。
このアクションは、次のプロジェクト項目で使用できます: テストモジュールおよびユーザー定義アクションです。
例・ケース1: 引数 window, control が指定された
window control rect text index
check text exists login login Login
例・ケース2: 引数 rect が指定された
window control rect text index
check text exists login login 1,1,100,100 Login
例・ケース3: 引数 index が指定された
window control rect text index
check text exists home TestArchitect 2
例・ケース4: 引数 text color が指定された
window control rect text index text color
check text exists home Churchy Joes FEFEFE
ビットマップテキストフラグメントとは、ビットマップ画像内で認識されたOCR文字列のことです。
- このビルトインアクションは、光学文字認識(OCR)とグラフィックス・デバイス・インターフェイス(GDI)の両方の技術を使用します。デフォルトでは、このアクションはOCR技術を使用します。GDI技術に切り替えるには、詳細についてはビルトイン設定 character recognition
technique を参照してください。重要:
- このビルトインアクションがGDI技術を適用する場合、DrawTextA (ANSI名), DrawTextW (Unicode名), TextOutA (ANSI名), TextOutW (Unicode名), ExtTextOutA (ANSI名), ExtTextOutW (Unicode名) を含む全ての Windows API が呼び出され、AUTによって生成された所望のテキストを再描画します。
- このアクションにおけるGDI技術の使用は、以下のシステム/プラットフォームでサポートされています: Windows(Win32、WinForms)
- このアクションは、キャプチャされたビットマップの一部であるアクティブエリアに適用され、画像の残りの部分は無視されます。アクティブエリアは引数 window, control, rect
の組み合わせによって決定されます。まず、ウィンドウとコントロールは、アクティブなUI要素を決定し、それは次のようになります:
アクティブなUI要素が確立されたら、引数 rect はアクティブなUI要素に対して相対的に(任意で)長方形のアクティブエリアを指定します。(引数 rect が指定されていない場合、アクティブなUI要素自体がアクティブエリアです)引数 window 引数 control アクティブなUI要素は... 省略 省略 画面全体(つまり、キャプチャされたテスト画像全体) 指定された 省略 アプリケーションウィンドウ全体 指定された 指定された 指定されたコントロール - ほとんどの場合、指定された場合、rectエリアはアクティブなUI要素内に存在する境界を定義し、その結果、rectエリアそのものがアクティブエリアとなります。ただし、必ずしもそのようなわけではありません。以下の3つのイメージは、rectエリアが指定された場合にアクティブエリアがどのように決定されるかを一般的なケースで示しています。
アクティブエリアを決定する一般的なルールは次の通りです:
rectエリア 結果として得られるアクティブエリア: 指定されていない アクティブなUI要素 アクティブなUI要素と重なる 交差する領域(上記のケース1およびケース2) アクティブなUI要素との重なりがない アクティブなUI要素(上記のケース3) - 引数 rect:
上記の図は、引数 window, control が指定された場合(アクティブUI要素としてピクチャコントロールを確立)、rect = 80,
30(つまり、左=80、上=30で、幅と高さはデフォルト値を仮定することが許可されています)の場合に適用されるアクティブエリアを示しています。
この場合、アクティブエリアとrectエリアが同じですが、必ずしもそうであるわけではありません。rectの4つのサブ引数のうち、いずれかを省略することができますが、全ての値は正しい割り当てを確保するためにコンマで区切られた位置を維持する必要があります(例えば、rectを, , 100, 50
に設定すると、幅=100、高さ=50のアクティブエリアが、アクティブなUI要素の左上隅と一致するように指定されます)。 - 引数 text:重要:このアクションは英語テキストのみをサポートしています。
- OCR技術の場合: このアクションの場合、case sensitive 設定 は、このアクションに対して正しいウィンドウやコントロールを識別するために使用されるプロパティ値に適用されますが、アクションのOCRテキスト識別機能は大文字小文字を区別せず、この設定の値に影響を受けません。
- 技術GDIの場合:
- このアクションのGDIテキスト識別機能は大文字小文字を区別し、case sensitive 設定の値に影響を受けます。
- この引数の値にはワイルドカードを適用することを強くお勧めします。なぜなら、指定された描画関数によって再描画されるテキストには周囲のノイズが含まれている可能性があるからです。例えば、値が{Administration.*}の場合、TestArchitect はAdministration.で始まる文字列に一致するテキストを検索します。より一般的に言えば、この引数は正規表現を受け入れます。
- 引数 text color:
- ビルトインアクション set ocr setting および OCR検出ツール を使用しない場合、値は必要ありません。
- それ以外の場合、テキストの色の値が必要であり、通常は OCR検出ツール を介して取得されます。これにより、OCR関連のビルトインアクションが指定されたテキストを正しく検出できるようになり、手動で OCR検出ツール を使用してテキストを識別する方法と同じ方法で検出できます。
- このアクションは <ignore>
修飾子をサポートしています。引数のいずれかの値として文字列
<ignore>
が含まれているか、或いはどの引数かが<ignore>
に評価される式を含んでいる場合、そのアクションは実行中にスキップされます。