「アイテム選択」アクティビティのご紹介をします。
1.アクティビティのプログラム名
RCA.Activities.Windows.SelectItem
2.説明
Studio バージョン 2.0.2.0まで
クイックアクセス: 「ツールボックス」 > 「ウィンドウアプリケーション」 > 「アイテム選択」
Studio バージョン 2.0.3.0から
クイックアクセス: 「ツールボックス」 > 「ウィンドウアプリケーション」 > 「アイテム選択」
ドロップダウンリスト(プルダウン)やリストボックスから項目を選択することができます。
※動作を確認したコボットStudioのバージョン:2.1.1.2
※バージョンによって文言などが一部異なる場合がございます
3.プロパティ
プロパティ項目 | プロパティ名 | 入力欄 | 説明 |
---|---|---|---|
オプション | From | 値を入力(UIElement型) | セレクタ文字列を持つ要素を検索する際に、UiElement変数をルートにする。 (設定されていない場合は、デスクトップのルートから探す) |
オートメーションベース | ドロップダウン選択 | UI自動化ライブラリのバージョンを指定する。 | |
使用ウィンドウ | 値を入力(WindowApp型) | 「ウィンドウを開く」や「ウィンドウにアタッチ」からの出力変数を使用して、アクティビティの対象ウィンドウを設定する。 | |
要素 | 値を入力(AutmationElement型) | セレクタ文字列の代わりに、入力としてAutomationElement型の変数を使用する。 | |
コレクションアイテム | インデックス順 | チェック項目 | 項目値をインデックスで指定する場合にチェックを入れる。 |
項目値 | 値を入力(String型) | 選択するアイテムの項目値を設定する。インデックス順にチェックが入っている場合は数字を入力する。 | |
選択タイプ | ドロップダウン選択 | 選択のタイプを選択します。詳細は以下。 | |
その他 | パブリック | チェック項目 | ログにアクティビティ内の変数と引数がログファイルに書き込まれ、Centerにプッシュされる。(詳細は「プロパティ項目「パブリック」について」を参照) |
表示名 | 任意の文字列 | デザイナーパネルのアクティビティ名に反映される。 | |
一般 | エラー時に続行 | 値を入力(Boolean型) | エラー時に後続の処理に進む。 |
タイムアウト | 値を入力(Int32型) | エラーになる前に指定した時間(ミリ秒)待機する。 | |
実行後の待機時間 | 値を入力(Int32型) | アイテム選択後に指定した時間(ミリ秒)待機する。 | |
実行前の待機時間 | 値を入力(Int32型) | アイテム選択前に指定した時間(ミリ秒)待機する。 | |
待機 | 消えるまで待機 | チェック項目 | UIが消えるまで待機する。 |
無効になるまで待機 | チェック項目 | UIが無効になるまで待機する。 | |
有効になるまで待機 | チェック項目 | UIが有効になるまで待機する。 | |
入力 | セレクタ | 値を入力(String型) | 対象要素を指定でクリックしたUI要素の詳細が反映される。 |
「コレクションアイテム」 > 「選択アイテム」プロパティは以下の3種類から選択できます。
選択アイテム | 詳細 |
---|---|
SELECT | 項目を選択します。 |
ADD_TO_SELECTION | 複数選択可能な場合に選択した項目を追加します。 |
REMOVE_FROM_SELECTION | 複数選択可能な場合に選択した項目を削除します。 |
※コボットStudio2.1.1.2現在、「ADD_TO_SELECTION」「REMOVE_FROM_SELECTION」において複数項目選択ができない事象を確認しております。今後修正予定です。
4.使い方
「アイテム選択」プロパティの実際の使用例を元に説明します。
【例】フォルダのプロパティ画面「カスタマイズ」タブの「フォルダの種類」メニューから「ミュージック」を選択する。
今回操作を行うフォルダに対しあらかじめ以下の手順で操作を行っておきます。
1.右クリックしメニューから「プロパティ」を選択する。
2.表示されたプロパティ画面から「カスタマイズ」タブをクリックする。
「ウィンドウアプリケーション」 > 「アイテム選択」アクティビティをドラッグ&ドロップでデザイナーパネルに配置します。
「要素を選択」から画面を進め、今回操作を行う「フォルダの種類」メニューの要素を選択します。要素の選択方法について詳しくは「セレクタの取得方法」をご参照ください。
次に各プロパティを設定します。それぞれ以下のように設定してください。
- 「コレクションアイテム」 > 「項目値」:"ミュージック"
- 「コレクションアイテム」 > 「選択タイプ」:SELECT
- 「一般」 > 「実行後の待機時間」:3000
※「実行後の待機時間」プロパティは今回実行後の結果をわかりやすくするために設定しています。
フォルダのプロパティ画面を出した状態のまま、「ホーム > スタート」をクリック、または、「F5キー」押下で実行します。実行すると選択したメニューから「ミュージック」が選択されます。