例・ケース１：　引数 window, control が指定された

        
        	window	control	rect	text	index	left	top
get text coordinates	login	login		Login		leftPos	topPos
        
    

結果

例・ケース２：　引数 index が指定された

        
        	window	control	rect	text	index	left	top
get text coordinates	home			TestArchitect	2	l_Pos	t_Pos
        
    

結果

例・ケース３：　引数 text color が指定された

        
        	window	control	rect	text	index	left	top	text color
get text coordinates	home			Churchy Joes		leftPos	leftTop	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要素を決定し、それは次のようになります：　

  引数 window	引数 control	アクティブなUI要素は...
  省略	省略	画面全体（つまり、キャプチャされたテスト画像全体）
  指定された	省略	アプリケーションウィンドウ全体
  指定された	指定された	指定されたコントロール

  アクティブなUI要素が確立されたら、引数 rect はアクティブなUI要素に対して相対的に（任意で）長方形のアクティブエリアを指定します。（引数 rect が指定されていない場合、アクティブな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.で始まる文字列に一致するテキストを検索します。より一般的に言えば、この引数は正規表現を受け入れます。
• 引数 left, top に指定された変数が宣言されていない場合、そのアクションはそれらをグローバル変数として生成します。
  引数 text color:
  • ビルトインアクション set ocr setting および OCR検出ツール を使用しない場合、値は必要ありません。
  • それ以外の場合、テキストの色の値が必要であり、通常は OCR検出ツール を介して取得されます。これにより、OCR関連のビルトインアクションが指定されたテキストを正しく検出できるようになり、手動で OCR検出ツール を使用してテキストを識別する方法と同じ方法で検出できます。
• このアクションは <ignore> 修飾子をサポートしています。引数のいずれかの値として文字列 <ignore> が含まれているか、或いはどの引数かが <ignore> に評価される式を含んでいる場合、そのアクションは実行中にスキップされます。