UI Automation のアクティビティ

最終更新日時 2024年12月20日

要素の存在を確認

UiPath.Core.Activities.UiElementExists

UI 要素が表示されていない場合でも、UI 要素が存在するかどうかを確認できます。

プロパティ

共通

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

入力

Target.Target - UI 要素を識別します。ドロップダウンリストから、[ターゲット]、[Null] のどちらかのオプションを選択します。既定のオプションは [ターゲット] です。
Target.ClippingRegion - UiElement を基準とし、左、上、右、下の方向で、クリッピング四角形 (ピクセル単位) を定義します。正と負の両方の値をサポートしています。
Target.Element - 別のアクティビティから返される UiElement 変数を使用します。このプロパティを Selector プロパティと一緒に使用することはできません。このフィールドでは UiElement 変数のみサポートされています。
Target.Selector - アクティビティの実行時に特定の UI 要素の検索に使用する Text プロパティです。実際には、検索しようとする GUI 要素とそのいくつかの親要素の属性を指定する XML フラグメントです。
Target.TimeoutMS - 要素が存在しない場合にアクティビティが実行されるまでの待機時間 (ミリ秒単位) を指定します。
Target.WaitForReady - アクションを実行する前に、ターゲットが準備完了になるまで待ちます。次のオプションを使用できます。
- NONE - ターゲット要素以外の要素の読み込みを待たずに、アクションを実行します。たとえば、UI 要素がすべて読み込まれるまで待つことなく、Web ページからテキストを取得したり、特定のボタンをクリックしたりする場合に、このオプションを使用できます。ボタンがまだ読み込まれていない要素 (スクリプトなど) に依存している場合、これは望ましくない結果を招く可能性があります。
- INTERACTIVE - 一部のアセットがまだ読み込まれている可能性がありますが、ターゲットアプリが準備完了を示すまで待機します。
COMPLETE - 操作を実際に実行する前に、ターゲットアプリのすべての UI 要素が読み込まれるのを待ちます。
注:
アプリケーションが対話または完了のどちらのステートにあるか調べるには、以下のタグを検証します。
- Desktop applications - <wnd> タグ、<ctrl> タグ、<java> タグ、または <uia> タグの存在を確認するために wm_null メッセージが送信されます。存在する場合、アクティビティが実行されます。
- Web アプリケーション：
- Internet Explorer - <webctrl> タグは、HTML ドキュメントの Ready ステートが Complete に設定されているかどうかを確認するために使用されます。また、Busy ステートは「False」に設定されている必要があります。
- Others - <webctrl> タグは、HTML ドキュメントの Ready ステートが Complete であるかどうかを確認するために使用されます。
- SAP applications - 最初に <wnd> タグを確認した後、SAP 固有の API を使用して、セッションがビジーかどうかを検出します。