does text exist

指定されたビットマップのテキストフラグメントが与えられた に存在するかを示すブール値を返します。
名前説明タイプ修飾子
window

ウィンドウのTA名です。

Interface Entityなし
control

コントロールのTA名です。

Interface Elementなし
rect

(任意)rectエリアの寸法を指定します。これは、引数 window, control によって決定されたアクティブなUI要素と組み合わせて、アクティブエリアを定義します。検索テキスト(textで定義)のスキャンは、このアクティブエリアに制限されます(詳細は を参照してください)。rectエリアの位置を指定する値は、アクティブなUI要素に対して相対的です。
引数 rect は、4つのコンマ区切りの値で構成されています。

  • : rectエリアの左端を、アクティブなUI要素(画面、ウィンドウ、またはコントロール - 詳細については を参照してください)の左端に対して相対的に指定します。(単位: ピクセル)
    デフォルト値:  0
  • : rectエリアの上端を、アクティブなUI要素の上端に対して相対的に指定します。(単位: ピクセル)
    デフォルト値:  0
  • : rectエリアの幅を指定します。(単位: ピクセル)
    デフォルト値:  アクティブエリアの右端がアクティブなUI要素の右端と一致するようにする値です。
  • 高さ: rectエリアの高さを指定します。(単位: ピクセル)
    デフォルト値:  アクティブエリアの下端がアクティブなUI要素の下端と一致するようにする値です。

Stringなし
text

検索する を表す文字列です。

Stringなし
index

(任意)検索テキストの最小出現回数を指定し、対象の が見つかったとみなされるためには、アクティブエリア内で発見される必要があります。

デフォルト値: 1
Stringなし
variable

(任意)返されたブール値を受け取る変数です。

使用可能な戻り値: 

  • 1: ターゲット テキストが見つかりました。
  • 0: ターゲット テキストが見つかりません。

Stringなし
text color

(任意)テキストのカラーコード、16進数表記です。(詳細は を参照してください)

この値はOCR検出ツール ダイアログボックスから取得されます。

Stringなし
指定されたビットマップテキストフラグメントが与えられたビットマップ内に存在するかを示すブール値です。
このアクションは、次のプロジェクト項目で使用できます: テストモジュールおよびユーザー定義アクションです。
次の設定はこのアクションに適用可能です:  case sensitive, remove double quotes from cells, standard ASCII only, object wait, window wait, load invisible controls.
例・ケース1: 引数 window, control が指定された

        
        	window	control	rect	text	index	variable
does text exist	login	login		Login		isExist
&nbsp						
	value	expected				
check value	#isExist	1				
        
    
例・ケース2: 引数 rect が指定された

        
        	window	control	rect	text	index	variable
does text exist	login	login	1,1,100,100	Login		isExist
&nbsp						
	value	expected				
check value	#isExist	1				
        
    
例・ケース3: 引数 index が指定された

        
        	window	control	rect	text	index	variable
does text exist	home			TestArchitect	2	isExist
&nbsp						
	value	expected				
check value	#isExist	1				
        
    
例・ケース4: 引数 text color が指定された

        
        	window	control	rect	text	index	variable
does text exist	home			Churchy Joes		result	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.で始まる文字列に一致するテキストを検索します。より一般的に言えば、この引数は正規表現を受け入れます。
  • 引数 variable: 
    • 引数 variable の変数が宣言されていない場合は、そのアクションはそれをグローバルとして作成します。
    • 引数 variable が空の場合は、 TestArchitect は「_result」という名前のグローバル変数に値を供給します。
  • 引数 text color:
    • ビルトインアクション set ocr setting および OCR検出ツール を使用しない場合、値は必要ありません。
    • それ以外の場合、テキストの色の値が必要であり、通常は OCR検出ツール を介して取得されます。これにより、OCR関連のビルトインアクションが指定されたテキストを正しく検出できるようになり、手動で OCR検出ツール を使用してテキストを識別する方法と同じ方法で検出できます。
  • このアクションは <ignore> 修飾子をサポートしています。引数のいずれかの値として文字列 <ignore> が含まれているか、或いはどの引数かが <ignore> に評価される式を含んでいる場合、そのアクションは実行中にスキップされます。

Copyright © 2024 LogiGear Corporation. All rights reserved. LogiGearはLogiGear Corporationの登録商標であり、Action Based TestingおよびTestArchitectはLogiGear Corporationの商標です。ここに記載されているその他の商標は、各所有者の財産です。

LogiGear Corporation

1730 S. Amphlett Blvd. Suite 200, San Mateo, CA 94402

Tel: +1 (650) 572-1400