「スクロール」アクティビティのご紹介をします。
1.アクティビティのプログラム名
RCA.Activities.Windows.Scroll
2.説明
Studio バージョン 2.0.2.0まで
クイックアクセス: 「ツールボックス」 > 「ウィンドウアプリケーション」 > 「スクロール」
Studio バージョン 2.0.3.0から
クイックアクセス: 「ツールボックス」 > 「ウィンドウアプリケーション」 > 「スクロール」
ウィンドウをスクロールします。
※動作を確認したコボットStudioのバージョン:2.1.1.2
※バージョンによって文言などが一部異なる場合がございます
3.プロパティ
プロパティ項目 | プロパティ名 | 入力欄 | 説明 |
---|---|---|---|
オプション | From | 値を入力(UIElement型) | セレクタ文字列を持つ要素を検索する際に、UiElement変数をルートにする (設定されていない場合は、デスクトップのルートから探す) |
オートメーションベース | ドロップダウン選択 | UI自動化ライブラリのバージョンを指定する。 | |
使用ウィンドウ | 値を入力(WindowApp型) | 「ウィンドウを開く」や「ウィンドウにアタッチ」からの出力変数を使用して、アクティビティの対象ウィンドウを設定する。 | |
要素 | 値を入力( AutomationElement 型) | セレクタ文字列の代わりに、入力としてAutomationElement型の変数を使用する。 | |
スクロール率 | 垂直方向のパーセント | 値を入力(Double型) | 垂直方向にスクロールする割合を設定する。 |
水平方向のパーセント | 値を入力(Double型) | 水平方向にスクロールする割合を設定する。 | |
スクロール量 | 垂直方向の量 | ドロップダウン選択 | 垂直方向にスクロールする量を設定する。 |
水平方向の量 | ドロップダウン選択 | 水平方向にスクロールする量を設定する。 | |
その他 | パブリック | チェック項目 | ログにアクティビティ内の変数と引数がログファイルに書き込まれ、Centerにプッシュされる。(詳細は「プロパティ項目「パブリック」について」を参照) |
表示名 | 任意の文字列 | デザイナーパネルのアクティビティ名に反映される。 | |
一般 | エラー時に続行 | 値を入力(Boolean型) | エラー時に後続の処理に進む。 |
タイムアウト | 値を入力(Int32型) | エラーになる前に指定した時間(ミリ秒)待機する。 | |
実行後の待機時間 | 値を入力(Int32型) | スクロールした後に指定した時間(ミリ秒)待機する。 | |
実行前の待機時間 | 値を入力(Int32型) | スクロールする前に指定した時間(ミリ秒)待機する。 | |
待機 | 消えるまで待機 | チェック項目 | UIが消えるまで待機する。 |
無効になるまで待機 | チェック項目 | UIが無効になるまで待機する。 | |
有効になるまで待機 | チェック項目 | UIが有効になる前に待機する。 | |
入力 | スクロールタイプ | ドロップダウン選択 | スクロールのタイプを選択する。詳細は以下。 |
セレクタ | 値を入力(String型) | 要素を指定でクリックしたUI要素の詳細が反映される。 |
スクロール量は以下の5つから選択できます。
スクロール量 | 説明 |
---|---|
LargeDecrement | マイナス方向に大きくスクロールする。 |
SmallDecrement | マイナス方向に小さくスクロールする。 |
NoAmount | スクロールしない。 ※例えば垂直方向だけスクロールする場合は、水平方向はNoAmountにします。 ※「スクロールタイプ」が「BY_PERCENT」の場合、垂直/水平共に何の値を選択してもNoAmountと認識されます。 |
LargeIncrement | プラス方向に大きくスクロールする。 |
SmallIncrement | プラス方向に小さくスクロールする。 |
スクロールタイプは以下の2種類が選択できます。
スクロールタイプ | 説明 |
---|---|
BY_AMOUNT | 指定した量でスクロールします。選択した場合、「スクロール率」は「0」を設定し、「スクロール量」を選択します。※「スクロール率」に「0」以外を設定した場合も設定が無視され「0」となります。 |
BY_PERCENT | 指定した割合でスクロールします。選択した場合、「スクロール量」は「NoAmount」になり、「スクロール率」に割合を選択します。※「スクロール量」で「NoAmount」以外を選択した場合も設定が無視され「NoAmount」となります。 |
4.使い方
「スクロール」の使い方を実際の使用例を元に説明します。
【例】テキストファイルをメモ帳で開き、縦方向にスクロールさせる。
今回は説明の為、以下のように既に内容が入力されているテキストファイルを使用します。
「ウィンドウアプリケーション」 > 「ウィンドウを開く」アクティビティを配置し、今回使用するテキストファイルをメモ帳で開く設定をします。
その後、「ウィンドウを開く」アクティビティの実行シーケンス内に「ウィンドウアプリケーション」 > 「スクロール」アクティビティを配置します。
「要素を指定」から画面を進め、スクロールさせたい部分を要素選択します。要素の選択方法は「セレクタの取得方法」をご参照ください。
次にプロパティを以下のように設定します。今回は垂直方向(縦)に30%スクロールします。
- 「スクロール率」 > 「垂直方向のパーセント」:30
- 「スクロール量」 > 「垂直方向の量」:NoAmount
- 「入力」 > 「スクロールタイプ」:BY_PERCENT
また、今回はスクロール後の結果を確認する為、「一般」 > 「実行後の待機時間」プロパティに「3000」と設定します。
「ホーム > スタート」をクリック、または、「F5キー」押下で実行します。実行すると指定したテキストファイルをメモ帳で開いた後、テキストエリアのスクロールを行います。
※スクロール前の状態を確認したい場合は、「実行前の待機時間」プロパティに「3000」などを設定します。「3000」ミリ秒を設定した場合、ワークフロー実行時にスクロールされていない状態が3秒表示され、スクロール後の状態が3秒表示されます。