テキストを検索

UiPath.Terminal.Advanced.Activities.TerminalFindTextInScreen

説明

入力として指定したテキストの最初の出現箇所を検索して、画面座標を返します。

このアクティビティは、[ターミナル セッション] アクティビティ内でのみ有効です。

プロジェクトの対応 OS

Windows - レガシ | Windows

構成

デザイナー パネル

• テキスト - 画面上で見つかったテキストです。このフィールドは、 String 変数と文字列のみをサポートします。
• 大文字小文字を区別しない - True に設定すると、画面上のテキストを検索する際に大文字と小文字が区別されません。

プロパティ パネル

共通

• 表示名 - アクティビティの表示名です。

入力

• 開始列 - 検索を開始する画面上の位置の列座標です。このフィールドでは整数および Int32 型の変数のみがサポートされています。
• 開始行 - 検索を開始する画面上の位置の行座標です。このフィールドでは整数変数と Int32 変数のみがサポートされています。
• テキスト - 画面上で見つかったテキストです。このフィールドは、 String 変数と文字列のみをサポートします。

その他

• プライベート - オンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。
  注:

  入力として指定したテキストが画面上で見つからない場合、このアクティビティは InvalidCoordinates 例外をスローします。

オプション

• 待機 (ミリ秒 ) - アクティビティを実行した後の遅延時間 (ミリ秒) です。既定の時間は 300 ミリ秒 (0.3 秒) です。
• 大文字小文字を区別しない - True に設定すると、画面上のテキストを検索する際に大文字と小文字が区別されません。
• タイムアウト (ミリ秒) - アクティビティの実行を待機できる時間 (ミリ秒単位) を指定します。この時間を超えるとエラーがスローされます。既定値は 5000 ミリ秒 (5 秒) です。
• WaitType - アクションを実行する前に、ターゲットが準備完了になるまで待機します。次のオプションが利用できます。
  • NONE - ターミナル キーボードが有効化されるまで待機しません。
  • READY / COMPLETE - ターミナル キーボードが有効化されるまで待機します。既定値は [READY] です。注: READY オプションと COMPLETE オプションは同じ機能を持ちます。これは、待機タイプが端末キーボードのステータスに関連しており、端末キーボードの状態は enabled または inhibit の 2 つの状態しかないためです。

出力

• 列 - 入力として指定したテキストの最初の出現箇所が見つかった列です。戻り値は Int32です。
• 行 - 入力として指定したテキストの最初の出現箇所が見つかった行です。戻り値は Int32です。