get text count

指定されたウィンドウまたはコントロールに存在するテキストフラグメントの総数を取得します。
名前説明タイプ修飾子
window

ウィンドウのTA名です。

Interface Entityなし
control

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

Interface Elementなし
drawing function

(任意)TestArchitect は、いくつかの描画関数によって描かれたテキストフラグメントを検出します。
許容値: 

  • DrawTextA: DrawTextA 関数(ANSI名)によって描かれたテキストを取得します。
  • DrawTextW: DrawTextW 関数(Unicode名)によって描かれたテキストを取得します。
  • TextOutA: TextOutA 関数(ANSI名)によって描かれたテキストを取得します。
  • TextOutW: TextOutW 関数(Unicode名)によって描かれたテキストを取得します。
  • ExtTextOutA: ExtTextOutA 関数(ANSI名)によって描かれたテキストを取得します。
  • ExtTextOutW: ExtTextOutW 関数(Unicode名)によって描かれたテキストを取得しま

Value SetDrawTextA, 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.
このアクションは、次のプロジェクト項目で使用できます: テストモジュールおよびユーザー定義アクションです。
次の設定はこのアクションに適用可能です:  case sensitive, remove double quotes from cells, standard ASCII only, object wait, window wait.

全ての6つの関数によって描画された「Administration」テキストの合計数を取得すると仮定します。

        
        	window	control	drawing function	variable	
get text content	Encounter	document type		text_content	
&nbsp					
	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> に評価される式を含んでいる場合、そのアクションは実行中にスキップされます。

Copyright © 2024 LogiGear Corporation. All rights reserved. LogiGear is a registered trademark, and Action Based Testing and TestArchitect are trademarks of LogiGear Corporation. All other trademarks contained herein are the property of their respective owners.

LogiGear Corporation

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

Tel: +1 (650) 572-1400