間隔の取得

verb: getRange

ユーザー・インターフェース・コントロールの最小値、最大値、および現在の範囲の値を取得します。

Windows においてコントロールとは、アプリケーションをユーザーが操作するためのエレメントのことです。ボタン、データ入力フィールド、メニューなど、さまざまなコントロールがあります。

構文

getRange --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)] (Numeric)=minimum (Numeric)=maximum (Numeric)=value

入力

スクリプト	Designer	必須	AcceptedTypes	Description
--selector	セレクター	必須	ControlSelectors	ユーザー・インターフェース・コントロールを指定するために使用するセレクターのタイプ。以下のオプションが選択可能です。クラスと値クラス名 ID ID と名前内部テキストおよびコントロール・タイプインスタンス名前名前と値タイプと索引タイプと名前 XPath IBM RPA Studioのレコーダーを使用してコントロールをマップし、「セレクター」パラメーターに必要な情報を取得することができます。また、これらのパラメーターを自動入力してスクリプトにコマンドを挿入することもできます。レコーダーは、プラットフォームの上部のツールバーで使用できます。
-- ID	ID	「セレクター」が「ID」、「ID と名前」の場合のみ	テキスト	UI コントロールの ID。
-- 名前	名前	「セレクター」が「名前」、「名前と値」、「ID と名前」、「タイプと名前」の場合のみ	テキスト	UI コントロールの名前。
--innertext	Text	「セレクター」が「内部テキストおよびタグ」の場合のみ	テキスト	UI コントロールの内部テキスト。
--tagname	エレメント名	「セレクター」が「内部テキストおよびタグ」の場合のみ	テキスト	エレメントまたはタグのタイプ。例: 「ボタン」、「テキスト・ボックス」。
-- XPath	XPath	「セレクター」が「XPath」の場合のみ	テキスト	UI コントロールの XPath。
--classname	クラス	「セレクター」が「クラスと値」、「クラス名」の場合のみ	テキスト	UI コントロールのクラス。
--elementvalue	エレメント値	「セレクター」が「クラスと値」、「名前と値」の場合のみ	テキスト	UI コントロールの現行値。
--controltype	タイプ	「セレクター」が「タイプと索引」、「タイプと名前」の場合のみ	ControlTypes	UI コントロールのタイプ。オプション: ボタンチェック・ボックス子ウィンドウコンボ・ボックス汎用画像ラベルリスト・ボックスメニュー・バーメニュー項目進行状況表示バーラジオボタンスクロール・バースライダースピナーステータス・バータブ・ページタブ・パネルテーブルテキストボックストグル・ボタンツリー表示 TreeTable ウィンドウ
-- 索引	索引	「セレクター」が「タイプと索引」の場合のみ	数値	UI コントロールの索引。
--control	Control	「セレクター」が「インスタンス」の場合のみ	コントロール	コントロールのインスタンス。この変数は、「コントロールの検索」コマンドを使用して取得されます。
--usetable	表内のエレメント	オプション	ブール値	有効にすると、表内のエレメントを取得します。
--searchbycolumn	列で検索	オプション	ブール値	有効にすると、行ではなく列を使用して、エレメントを取得します。
--searchcolumn	列	「表内のエレメント」が「True」の場合のみ	テキスト	エレメントを取得する列の名前または番号。
--searchvalue	値	「列で検索」が「True」の場合のみ	テキスト	表内のエレメントを検索するために使用する値。
--returncolumn	戻り列	「列で検索」が「True」の場合のみ	テキスト	コントロールが含まれている列。
-- 行	行	「列で検索」が「False」の場合のみ	数値	エレメントを取得する表の行。
-- タイムアウト	タイムアウト	オプション	時間幅、数値、テキスト	コマンド実行のタイムアウト。「タイムアウト」パラメーターに値が定義されていない場合、実行では、「タイムアウトの設定」コマンドによって定義されたコンテキスト・タイムアウトが使用されます。このコマンドをスクリプトで使用していない場合、デフォルトのタイムアウトは 5 秒です。

出力

スクリプト	Designer	AcceptedTypes	Description
最小	最小値	数値	コントロールの範囲の最小値。
maximum	最大値	数値	コントロールの範囲の最大値。
値	現行値	数値	コントロールの範囲の現行値。

例

ウィンドウが表示されるまで待機のコマンドを使用して、Windows エクスプローラーのウィンドウが表示されるまで待機します。 間隔の取得 コマンドで、ウィンドウの検索の進行状況表示バーの最小値、最大値、および現行値を取得し、それらの取得した値を「intervalMinimumValue」、「intervalMaximumValue」、および「intervalCurrentValue」にそれぞれ保管します。「ログ・メッセージ」コマンドは、 IBM RPA Studioの結果を示します。

defVar --name windowSuccess --type Boolean
defVar --name intervalMinimumValue --type Numeric
defVar --name intervalMaximumValue --type Numeric
defVar --name intervalCurrentValue --type Numeric
waitWindow --title "This PC" --classname CabinetWClass --processname explorer windowSuccess=success
// If the window appears, get the range.
if --left "${windowSuccess}" --operator "Is_True"
	getRange --selector "XPath" --xpath "/root/pane[2]/pane[4]/progressbar[1]" intervalMinimumValue=minimum intervalMaximumValue=maximum intervalCurrentValue=value
	logMessage --message "Current: ${intervalCurrentValue}\r\nMinimum: ${intervalMinimumValue}\r\nMaximum: ${intervalMaximumValue}" --type "Info"
// Waits for an open Explorer window and gets the range of the Explorer search progress bar.
endIf

この例では、システム・デフォルトが英語の場合、「タイトル」が「This PC」であるオープン・ウィンドウを「ウィンドウが表示されるまで待機」コマンドに挿入する必要があります。システムのデフォルト言語が異なる場合は、「ウィンドウが表示されるまで待機」コマンドの「タイトル」パラメーターのタイトルを変更する必要があります。