get text count
指定されたウィンドウまたはコントロールに存在するテキストフラグメントの総数を取得します。
名前 | 説明 | タイプ | 修飾子 |
---|---|---|---|
window | ウィンドウのTA名です。 | Interface Entity | なし |
control | コントロールのTA名です。 | Interface Element | なし |
drawing function | (任意)TestArchitect は、いくつかの描画関数によって描かれたテキストフラグメントを検出します。
| Value Set | DrawTextA, DrawTextW, TextOutA, TextOutW, ExtTextOutA, ExtTextOutW |
text | 検索する を表す文字列です。 | String | なし |
index | (任意)検索テキストの最小出現回数を指定し、対象の が見つかったとみなされるためには、アクティブエリア内で発見される必要があります。 デフォルト値: 1 | String | なし |
variable | (任意)返された値を受け取る変数です。 | String | なし |
A count of the total number of text fragments residing in a given window/control.
このアクションは、次のプロジェクト項目で使用できます: テストモジュールおよびユーザー定義アクションです。
全ての6つの関数によって描画された「Administration」テキストの合計数を取得すると仮定します。
window control drawing function variable
get text content Encounter document type text_content
 
window control drawing function text variable
get text count Encounter document type {.*Administration.*} text_count
合計数は2です。なぜなら、「Administration」テキストはExtTextOutAおよびExtTextOutWという2つの関数によって2回描画されるからです。
ビットマップテキストフラグメントとは、ビットマップ画像内で認識されたOCR文字列のことです。
- このビルトインアクションは、光学文字認識(OCR)とグラフィックス・デバイス・インターフェイス(GDI)の両方の技術を使用します。
- 引数 drawing function:
- デフォルトでは、引数の値が省略された場合、このビルトインアクションは自動的に全ての利用可能な描画関数を使用します。これは、各描画関数が順番に検証されるため、パフォーマンスの問題を引き起こす可能性があります。
- 自動化のパフォーマンスを向上させるために、どの正確な描画関数を使用するべきかを決定するには、インターフェイス ビューアで提供されるテキスト認識機能を使用してください。詳細はこちらを参照してください。
- 複数の値を同時に使用する場合、値と値の間にセミコロン ( ; ) を区切り文字として使用してください。
引数 text:
重要:このアクションは英語テキストのみをサポートしています。- ビルトイン設定 case sensitive は、このアクションの正しいウィンドウまたはコントロールを識別するために使用されるプロパティ値に適用されます。また、アクションのGDIテキスト識別機能も大文字と小文字を区別し、この設定の値に影響を受けます。
- この引数の値にはワイルドカードを適用することを強くお勧めします。なぜなら、指定された描画関数によって再描画されたテキストには周囲のノイズが含まれる可能性があるからです。例えば、値が{Administration.*}の場合、TestArchitect は文字列の先頭がAdministrationに一致するテキストを検索します。一般的に、この引数は正規表現を受け入れます。
- 引数 variable:
- 引数 variable の変数が宣言されていない場合は、そのアクションはそれをグローバルとして作成します。
- 引数 variable が空の場合は、 TestArchitect は「_result」という名前のグローバル変数に値を供給します。
- このアクションは修飾子 <ignore> をサポートしています。引数のいずれかの値として文字列
<ignore>
が含まれているか、或いはどの引数かが<ignore>
に評価される式を含んでいる場合、そのアクションは実行中にスキップされます。