コボットPortal

「要素の有無を検出」アクティビティのご紹介をします。

1.アクティビティのプログラム名

RCA.Activities.Windows.ElementExists

2.説明

Studio バージョン 2.0.2.0まで

  クイックアクセス: 「ツールボックス」 > 「ウィンドウアプリケーション」 > 「要素の有無を検出」

Studio バージョン 2.0.3.0から

  クイックアクセス: 「ツールボックス」 > 「ウィンドウアプリケーション」 > 「要素の有無を検出」

指定したウィンドウ要素が存在するかどうかを確認することができます

※動作を確認したコボットStudioのバージョン:2.1.1.2
※バージョンによって文言などが一部異なる場合がございます


3.プロパティ

プロパティ項目プロパティ名入力欄説明
オプションFrom値を入力(UIElement型)

セレクタ文字列を持つ要素を検索する際に、UiElement変数をルートにする。

(設定されていない場合は、デスクトップのルートから探す)

オートメーションベースドロップダウン選択UI自動化ライブラリのバージョンを指定する。
使用ウィンドウ値を入力(WindowApp型)「ウィンドウを開く」や「ウィンドウにアタッチ」からの出力変数を使用して、アクティビティの対象ウィンドウを設定する。
要素値を入力(AutomationElement型)セレクタ文字列の代わりに、入力としてAutomationElement型の変数を使用する。
その他パブリックチェック項目ログにアクティビティ内の変数と引数がログファイルに書き込まれ、Centerにプッシュされる。(詳細は「プロパティ項目「パブリック」について」を参照)
表示名任意の文字列デザイナーパネルのアクティビティ名に反映される。
一般エラー時に続行値を入力(Boolean型)エラー時に後続の処理に進む。
タイムアウト値を入力(Int32型)エラーになる前に指定した時間(ミリ秒)待機する。
実行後の待機時間値を入力(Int32型)検出を行った後に指定した時間(ミリ秒)待機する。
実行前の待機時間値を入力(Int32型)検出を行う前に指定した時間(ミリ秒)待機する。
出力要素の有無値を入力(Boolean型)検出の結果を格納する変数を設定する。
待機消えるまで待機チェック項目UIが消えるまで待機する。
無効になるまで待機チェック項目UIが無効になるまで待機する。
有効になるまで待機チェック項目UIが有効になるまで待機する
入力セレクタ値を入力(String型)対象要素を指定でクリックしたUI要素の詳細が反映される。



4.使い方

「要素の有無を検出」アクティビティの実際の使用例を元に説明します。

【例】エクスプローラーを開いて画面左のメニュー「PC」 > 「デスクトップ」の要素を検出する。

「ウィンドウアプリケーション」 > 「ショートカットキーを送信」アクティビティをドラッグ&ドロップでデザイナーパネルに配置する。

配置したらエクスプローラーを開くショートカットキーを設定します。今回は「Window」キー+「E」で設定します。以下のようにプロパティを設定します。

  • 「その他」 > 「Windowsキー」:チェック
  • 「その他」 > 「キー」:KEY_E

※今回の設定は一例です。

「ウィンドウアプリケーション」 > 「要素の有無を検出」アクティビティをドラッグ&ドロップでデザイナーパネルに配置する。

「要素を選択」から画面を進め、対象の要素を指定します。要素の選択方法について詳しくは「セレクターの使い方」をご参照ください。

次にプロパティを設定します。「出力」 > 「要素の有無」プロパティにBoolean型変数を設定します。(今回は「ElementResult」とします。)変数の作成方法について詳しくは「変数の作成」をご参照ください。また、今回は検出までの時間を短くするため「一般」 > 「タイムアウト」プロパティを「3000」に設定します。

次に「コア」 > 「ダイアログ」 > 「メッセージボックス」アクティビティをドラッグ&ドロップでデザイナーパネルに配置し、「入力」 > 「テキスト」プロパティに「[先程設定したBoolean型変数].ToString」と設定します。(今回は「ElementResult.ToString」と設定します)

「ホーム > スタート」をクリック、または、「F5キー」押下で実行します。

【「PC」のアイテムツリーが展開されている場合】

エクスプローラーを開いた後、メッセージボックスに「True」と表示されます。

【「PC」のアイテムツリーが折りたたまれている場合】

エクスプローラーを開いた後、メッセージボックスに「False」と表示されます。

印刷
H
Hyuga is the author of this solution article.

この回答は役に立ちましたか? はい いいえ

フィードバックを送信
お役に立てなくて申し訳ありません。フィードバックを残し、このアーティクルを改善するのにどうかご協力ください。