ツリーの展開

入力されたノードに従って TreeView コントロールを展開します。 コンピューティングにおいて、TreeView とは、階層データをツリー形式で表示できるグラフィック・インターフェース・エレメントです。ブランチやノードを展開表示/省略表示できます。

構文

expandTree --path(String) [--delay(TimeSpan)] [--forcerefresh(Boolean)] --selector(ControlSelectors) --id(String) --name(String) --innertext(String) --tagname(String) --xpath(String) --classname(String) --elementvalue(String) --controltype(Nullable<ControlTypes>) --index(Numeric) --control(Control) [--usetable(Boolean)] [--searchbycolumn(Boolean)] --searchcolumn(String) --searchvalue(String) --returncolumn(String) --row(Numeric) [--timeout(TimeSpan)]

入力パラメーター

以下の表は、このコマンドで使用可能な入力パラメーターのリストを示しています。 この表では、 IBM RPA Studioのスクリプト・モードで作業しているときのパラメーター名と、それに相当する Designer モードのラベルを確認できます。

「デザイナー」モードのラベル 「スクリプト」モードの名前 必須 使用可能な変数タイプ Description
Path path Required Text 展開する TreeView のパス。各ノードを改行で区切ります。
遅延 delay Optional Time Span, Number, Text TreeView ノードを 1 つ展開するたびに空ける時間間隔。
画面キャッシュの更新 forcerefresh Optional Boolean これを有効にすると、コマンドを実行する前に画面を再度読み取ります。 これを使用して、新規エレメントを識別し、画面キャッシュを更新します。

** 注:** これは、画面が頻繁に変更される場合に必要です。
セレクター selector Required ControlSelectors ユーザー・インターフェース・コントロールを指定するために使用するセレクターのタイプ。 詳しくは、 selector パラメーター・オプション を参照してください。

注: IBM RPA Studioのレコーダーを使用して、コントロールをマップし、セレクターを取得します。
ID id Only when selector is Id, IdAndName Text TreeView コントロールの ID。
名前 name Only when selector is Name, NameAndValue, IdAndName, TypeAndName Text TreeView コントロールの名前。
Text innertext Only when selector is InnerTextAndTag Text TreeView コントロールの内部テキスト。
エレメント・タイプ tagname Only when selector is InnerTextAndTag Text TreeView が展開されているエレメントのタイプ。
XPath xpath Only when selector is XPATH Text TreeView コントロールへの XPath。
クラス classname Only when selector is ClassAndValue, ClassName Text TreeView コントロールのクラス。
エレメント値 elementvalue Only when selector is ClassAndValue, NameAndValue Text TreeView を展開するエレメントの現行値。
タイプ controltype Only when selector is TypeAndIndex, TypeAndName ControlTypes TreeView のコントロール・タイプ。
索引 index Only when selector is TypeAndIndex Number コントロールの索引。
Control control Only when selector is Instance Control コントロールのインスタンス。

注: 検索コントロール コマンドを使用して、制御を取得してください。
表内のエレメント usetable Optional Boolean 有効にすると、列または行を使用して、表内のエレメントを検索できます。
列で検索 searchbycolumn Optional Boolean 有効にすると、行ではなく列を介してエレメントがフェッチされます。
列 searchcolumn Only when element in table is True Text エレメントを取得する列の名前または番号。
値 searchvalue Only when search by column is True Text 表内のエレメントを検索するために使用する値。
戻り列 returncolumn Only when search by column is True Text コントロールが含まれている列。
行 row Only when search by column is False Number エレメントを検索する表の行。
タイムアウト timeout Optional Time Span, Number, Text コマンド実行タイムアウト。

注: timeout パラメーターに値が定義されていない場合、実行では、「タイムアウトの設定」コマンドによって定義されたコンテキスト時間が使用されます。 このコマンドをスクリプトで使用していない場合、デフォルトの時間は 5 秒です。

selector パラメーター・オプション

次の表は、selector 入力パラメーターで使用可能なオプションを示しています。 この表は、「スクリプト」モードで作業するときに使用可能なオプションと、「デザイナー」モードでそれに相当するラベルを示しています。

「デザイナー」モードのラベル 「スクリプト」モードの名前 Description
クラスと値 ClassAndValue クラス名と値属性に基づいてエレメントを突き合わせます。
クラス名 ClassName ブラウザーのインターフェース・コントロールのクラス名。
ID Id 「ID」属性値に基づいてエレメントを突き合わせます。
ID と名前 IdAndName ID および名前属性値に基づいてエレメントを突き合わせます。
内部テキストおよびコントロール・タイプ InnerTextAndTag エレメント・テキスト・コンテンツとタグ名属性値に基づいてエレメントを突き合わせます。
インスタンス Instance コントロール・インスタンス
リンク・テキスト LinkText リンク・テキスト属性値に基づいてエレメントを突き合わせます。
名前 Name 「名前」属性値に基づいてエレメントを突き合わせます。
名前と値 NameAndValue 名前と値属性に基づいてエレメントを突き合わせます。
タイプとインデックス TypeAndIndex ブラウザー・インターフェースのコントロールのタイプと索引。
タイプと名前 TypeAndName ブラウザーに帰属するコントロールのタイプと名前。
XPath XPath HTML ルート内の XML パスに基づいてエレメントを突き合わせます。

controltype パラメーター・オプション

次の表は、controltype 入力パラメーターで使用可能なオプションを示しています。 この表は、「スクリプト」モードで作業するときに使用可能なオプションと、「デザイナー」モードでそれに相当するラベルを示しています。

「デザイナー」モードのラベル 「スクリプト」モードの名前 Description
ボタン Button これは、アプリケーションのボタン・コントロールに相当します。
チェック・ボックス CheckBox これは、アプリケーションのチェック・ボックス・コントロールに相当します。
子ウィンドウ ChildWindow これは、アプリケーションの子ウィンドウ・コントロールに相当します。
コンボ・ボックス ComboBox これは、アプリケーションのコンボ・ボックス・コントロールに相当します。
一般 Generic これは、アプリケーションの一般コントロールに相当します。
画像 Image これは、アプリケーションのイメージ・コントロールに相当します。
ラベル Label これは、アプリケーションのラベル・コントロールに相当します。
リスト・ボックス ListBox これは、アプリケーションのリスト・ボックス・コントロールに相当します。
メニュー・バー MenuBar これは、アプリケーションのメニュー・バー・コントロールに相当します。
メニュー項目 MenuItem これは、アプリケーションのメニュー項目コントロールに相当します。
進行状況表示バー ProgressBar これは、アプリケーションの進行状況表示バー・コントロールに相当します。
ラジオ・ボタン RadioButton これは、アプリケーションのラジオ・ボタン・コントロールに相当します。
スクロール・バー ScrollBar これは、アプリケーションのスクロール・バー・コントロールに相当します。
スライダー Slider これは、アプリケーションのスライダー・コントロールに相当します。
スピナー Spinner これは、アプリケーションのスピナー・コントロールに相当します。
ステータス・バー StatusBar これは、アプリケーションのステータス・バー・コントロールに相当します。
タブ・ページ TabPage これは、アプリケーションのタブ・ページ・コントロールに相当します。
タブ・パネル TabPanel これは、アプリケーションのタブ・パネル・コントロールに相当します。
表 Table これは、アプリケーションの表コントロールに相当します。
テキスト・ボックス TextBox これは、アプリケーションのテキスト・ボックス・コントロールに相当します。
ツリー表示 TreeView これは、アプリケーションのツリー・ビュー・コントロールに相当します。
TreeTable TreeTable これは、アプリケーションの TreeTable コントロールに相当します。
ウィンドウ Window これは、アプリケーションのウィンドウ・コントロールに相当します。

例

以下の状況では、ローカル・アプリケーションの TreeView コントロールを展開しています。

defVar --name applicationWindow --type Window
defVar --name executionSuccess --type Boolean
// Download the following file to execute the command.
launchOrAttach --executablepath "CSharpTestApp.exe" --title Users applicationWindow=value executionSuccess=success
assert --message "Did not find the demo application!" --left "${executionSuccess}" --operator "Is_True"
focusWindow --window ${applicationWindow}
expandTree --path "Tree\r\nColors\r\nBlue\r\n" --delay 00:00:01 --selector "Id" --id treeView1
// Wait 1 second between the expansion of each node to make visualization easier.