UiPath Activities

UiPath Activities ガイド

子要素を探す (Find Children)

UiPath.Core.Activities.FindChildren

指定した範囲とフィルター条件に従って、子の UI 要素のコレクションを取得します。

プロパティ

入力

  • Filter - コレクション内のすべての UI オブジェクトが満たす必要のある条件を指定する XML 文字列です。

オプション

  • Scope - コレクションにある UI 要素の範囲を設定できます。指定できるオプションは次のとおりです。

    • FIND_CHILDREN - 指定した要素直下の子要素も検索対象にします。
    • FIND_DESCENDANTS - 子要素をはじめとして、下位に連なる要素も検索対象にします。
    • FIND_TOP_LEVEL - 子要素の順序と個数を検索対象にします。
    • FIND_PROCESS - 子要素のデータ型を検索対象にします。
    • FIND_THREAD - 子要素の既定値および固定値を検索対象にします。

出力

  • - 設定されたフィルターとスコープに従って見つけられたすべての子 UI です。このフィールドは IEnumerable 変数のみをサポートします。

その他

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

共通

  • DisplayName - アクティビティの表示名です。
  • エラー発生時に実行を継続 - アクティビティがエラーをスローした場合でも、ワークフローを継続するかどうかを指定します。このフィールドではブール値 (True、False) のみサポートされています。既定値は False です。その結果、フィールドが空白でエラーがスローされると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。

📘

注:

このアクティビティが [トライ キャッチ] に含まれていて、[エラー発生時に処理を続行] プロパティの値が True の場合、プロジェクトが実行されたときにエラーは発生しません。

3 か月前に更新


子要素を探す (Find Children)


改善の提案は、API 参照ページでは制限されています

改善を提案できるのは Markdown の本文コンテンツのみであり、API 仕様に行うことはできません。