- 概要
- UI Automation
- UI Automation を使用して自動化されるアプリケーションと技術
- プロジェクトの対応 OS
- UI-ANA-016 - [ブラウザーを開く] に使用されている URL を検出
- UI-ANA-017 - [エラー発生時に実行を継続] の値が True
- UI-ANA-018 - OCR/画像関連のアクティビティのリスト
- UI-DBP-006 - コンテナーの使用
- UI-DBP-013 - Excel の自動化方法の誤用
- UI-DBP-030 - セレクター内での変数の使用禁止
- UI-PRR-001 - クリックをシミュレート
- UI-PRR-002 - 入力をシミュレート
- UI-PRR-003 - [アプリケーションを開く] の誤用
- UI-PRR-004 - ハードコードされた待機時間
- UI-REL-001 - セレクター内の大きいインデックス値
- UI-SEC-004 - メール アドレスのデータを含むセレクター
- UI-SEC-010 - アプリ/URL の制限
- UI-USG-011 - 許可されていない属性
- UX-SEC-010 - アプリ/URL の制限
- UX-DBP-029 - セキュリティで保護されていないパスワードの使用
- UI-PST-001 - [プロジェクト設定] の監査ログ レベル
- UiPath ブラウザー移行ツール
- Computer Vision レコーダー
- アクティベート
- アンカー ベース
- ブラウザーにアタッチ
- ウィンドウにアタッチ
- ユーザー入力をブロック
- トランザクションを呼び出し
- 吹き出し
- チェック
- クリック
- 画像をクリック
- 画像クリック トリガー
- OCR で検出したテキストをクリック
- 画面上の画像をクリック
- テキストをクリック
- ツールバー ボタンをクリック
- クリック トリガー
- アプリケーションを閉じる
- タブを閉じる
- ウィンドウを閉じる
- コンテキスト対応のアンカー
- 選択されたテキストをコピー
- 要素属性変更トリガー
- 要素の存在を確認
- 要素スコープ
- 要素ステート変更トリガー
- ALV 階層テーブルを展開
- ALV ツリーを展開
- ツリーを展開
- UI ツリーをエクスポート
- 構造化データを抽出
- 子要素を探す
- 要素を探す
- 画像を探す
- 一致する画像を探す
- OCR でテキスト位置を探す
- 相対要素を探す
- テキスト位置を探す
- アクティブ ウィンドウを取得
- 親要素を取得
- 属性を取得
- イベント情報を取得
- クリップボードから取得
- フル テキストを取得
- OCR でテキストを取得
- パスワードを取得
- 位置を取得
- ソース要素を取得
- テキストを取得
- 表示中のテキストを取得
- 前に戻る
- 次に進む
- ホームに移動
- Google Cloud Vision OCR
- ウィンドウを隠す
- 強調表示
- ホットキー トリガー
- ホバー
- 画像上でホバー
- OCR で検出したテキスト上でホバー
- テキスト上でホバー
- 画像の存在を確認
- 画面上で指定
- .NET コードを挿入
- JS スクリプトを挿入
- ActiveX メソッドを呼び出し
- キー操作トリガー
- 画像を読み込み
- ウィンドウを最大化
- Microsoft Azure ComputerVision OCR
- Microsoft OCR
- Microsoft Project Oxford Online OCR
- ウィンドウを最小化
- イベントを監視
- マウス トリガー
- ウィンドウを移動
- URL に移動
- OCR でテキストの存在を確認
- 要素が出現したとき
- 要素が消滅したとき
- 画像が出現したとき
- 画像が消滅したとき
- アプリケーションを開く
- ブラウザーを開く
- ステータス バーを読み取り
- ブラウザーを更新
- ユーザー イベントを再生
- ウィンドウを復元
- SAP にログイン
- SAP にログオン
- SAP セッション属性変更トリガー
- 画像を保存
- カレンダーから日付を選択
- 項目を選択
- メニュー項目を選択
- 複数の項目を選択
- ホットキーを押下
- クリッピング領域を設定
- フォーカスを設定
- テキストを設定
- クリップボードに設定
- Web 属性を設定
- ウィンドウを表示
- プロセスを開始
- システム トリガー
- 表のセル スコープ
- スクリーンショットを作成
- Tesseract OCR
- テキストの存在を確認
- ツールチップ
- 文字を入力
- SecureString で文字を入力
- フォアグラウンドを使用
- 属性を待つ
- 要素の消滅を待つ
- 画像の消滅を待つ
- Computer Vision ローカル サーバー
- モバイル オートメーション
- ターミナル
アプリケーション イベント トリガー
UiPath.UIAutomationNext.Activities.NNativeEventTrigger
任意の種類の要素 (トップレベル ウィンドウやその他の指定した UI 要素) のネイティブ イベントに基づいてトリガーを設定します。画面上でターゲット要素を指定し、その要素でサポートされているイベントのリストからネイティブ イベントを選択できます。
このアクティビティはオブジェクト リポジトリに対応しています。
トリガーはワークフローの最初のアクティビティである必要があります。ワークフローは、特定の UI イベントが発生するとトリガーされます。ワークフローごとに許可されるトリガーは 1 つのみです。詳しくは、「トリガーベースの有人オートメーション」をご覧ください。
2023.4 より前のバージョンの Studio を使用している場合、[アプリケーション イベント トリガー] アクティビティを [トリガー スコープ] アクティビティ内に配置する必要があります。この場合、[アプリケーション イベント トリガー] アクティビティの [スケジュール モード] プロパティと [有効] プロパティは表示されません。[トリガー スコープ] アクティビティの [スケジュール モード] プロパティが利用可能です。
デザイナー パネル
-
[画面上でターゲットを指定] をクリックして、ターゲットとして使用する UI 要素を指定します。
ターゲットを指定したら、メニュー ボタンをクリックします。以下のオプションが表示されます。
- 画面上でターゲットを指定 - ターゲットをもう一度指定します。
- ターゲットを編集 - 選択モードを開いて、ターゲットを設定します。
- 参考スクリーンショットを削除 - 対象のアプリケーションまたは Web ページのスクリーンショットを削除します。
- オブジェクト リポジトリに追加 - 現在の UI 要素をライブラリ プロジェクトに追加し、オートメーション プロセス全体で要素を再利用することができます。
-
イベントの種類 - 指定した要素に固有のネイティブのイベントの種類のリストです。イベントの種類を設定する必要があります。公開されるイベントのリストは、ターゲット要素の種類と対象のアプリケーションのテクノロジによって異なります。たとえば、Web UI 要素で公開されるイベントのリストは、Java UI 要素とは異なる場合があります。
プロパティ パネル
共通
-
表示名 - デザイナー パネルに表示される、アクティビティの名前です。表示名は、ターゲットを指定すると自動的に生成されます。
入力
-
同期的なマッチング - ターゲット要素のセレクターのマッチングを同期的に実行するか、非同期的に実行するかを指定します。[出現] と [消滅] を除く Java イベントでのみサポートされています。このフィールドでは
Boolean
値のみがサポートされています。既定値は [False] です。 - セレクター - 指定したイベントを監視するためのセレクターの任意のコレクションです。これらのセレクターは、指定したターゲットと一緒に監視されます。セレクターは、完全セレクター (部分セレクターではない) である必要があります。
-
ターゲット - ターゲット要素です。トップレベルのウィンドウまたは UI 要素です。アンカーがない厳密セレクターのみがサポートされています。ターゲット要素を設定する必要があります。ターゲットを画面で指定するまで、このフィールドは
(null)
に設定されています。ターゲットを指定すると、指定した要素に関連するすべてのプロパティが表示されます。- 厳密セレクター - ターゲット UI 要素に対して生成される厳密セレクターです。トップレベルのウィンドウの場合は空です。
- ウィンドウ セレクター (アプリケーション インスタンス) - アプリケーション ウィンドウ (アプリケーション/ブラウザー) のセレクターです。
その他
-
有効 - [False] に設定すると、トリガーは起動しますがイベントは開始されません。後で [ローカル トリガーを有効化] アクティビティを使用して実行時に有効化できます。このプロパティは、[アプリケーション イベント トリガー] アクティビティが [トリガー スコープ] 内に配置されている場合は非表示になります。このフィールドでは、
Boolean
値のみがサポートされています。既定値は [True]です。 - プライベート - オンにすると、変数および引数の値が Verbose レベルでログに出力されなくなります。このフィールドでは、
Boolean
値 (True、False) のみがサポートされています。既定値は False です。
オプション
-
子を含む - 選択すると、指定した UI 要素の子も監視されます。[出現] または [消滅] を除くすべてのイベントの種類と、トップレベル ウィンドウを除くすべての UI 要素をサポートしています。このフィールドでは、
Boolean
値 (True、False) のみがサポートされています。既定値は False です。 - スケジュール モード - トリガーが発生した場合のアクションの実行方法を指定します。ドロップダウン メニューから次の 5 つのオプションのいずれかを選択します。
- Sequential - アクションは 1 つずつ順番に実行されます。
- Concurrent - アクションの実行が重なる場合があります。
- OneTime - 1 つのアクションを実行し、監視を終了します。
- SequentialCollapse - 現在のイベントの実行が完了するまで、今後発生するすべてのイベント (最新のイベントを除く) を無視します。
- 順次 (drop) - 前のイベントの実行を停止し、次のイベントを開始します。
[順次] と [同時] モードでは、ユーザーが実行を停止するか [繰り返しを終了] アクティビティに到達するまで監視が継続します。
さまざまな種類のアプリケーション テクノロジでサポートされる一連のイベント セットを新たに実装し、ネイティブ イベントの監視メカニズムを改良しました。
- WND ネイティブ イベント
- CTRL のネイティブ イベント
- JAVA のネイティブ イベント
- WEBCTRL のネイティブ イベント
- HTML ネイティブ イベント
- UIA のネイティブ イベント
予定の種類 |
TriggerEventArgs の種類 | 説明 |
---|---|---|
出現 | EmptyArgs | ターゲット要素が出現したときにトリガーされます。 |
消滅 | EmptyArgs | ターゲット要素が消滅したときにトリガーされます。 |
タイトルの変更 | TextChangedArgs |
ターゲット要素のタイトルが変更されたときにトリガーされます。
注: これは、[テキストの変更] イベントです。トップレベル ウィンドウについては、明確化するため、名前が [タイトルの変更] に変更されました。
|
ステートの変更 | StateChangedArgs | ターゲット要素のステートが変更されたときにトリガーされます。
注: このイベントは、ウィンドウのステートに何らかの変更 (有効化、無効化、選択、選択解除、フォーカス可能、フォーカス、表示など) があった場合にトリガーされます。ステートの新しい値は、引数の変数で公開されます。
|
場所の変更 | LocationChangedArgs | ターゲット要素の場所が変更されたときにトリガーされます。 |
最前面に表示 | HwndArgs | ターゲット要素のウィンドウがフォアグラウンド ウィンドウになったときにトリガーされます。 |
背面に表示 | HwndArgs | ターゲット要素のウィンドウが最前面に表示されなくなったときにトリガーされます。 |
最小化 | HwndArgs | ターゲット要素のウィンドウが最小化されようとしているときにトリガーされます。 |
復元 | HwndArgs | ターゲット要素のウィンドウが復元されようとしているときにトリガーされます。 |
予定の種類 | TriggerEventArgs の種類 | 説明 |
---|---|---|
出現 | EmptyArgs | ターゲット要素が出現したときにトリガーされます。 |
消滅 | EmptyArgs | ターゲット要素が消滅したときにトリガーされます。 |
キーの押下 | KeyPressArgs | ターゲット要素内にフォーカスがある状態でキーが押下されたときにトリガーされます。 |
クリック | MouseClickedArgs | ターゲット要素がクリックされたときにトリガーされます。 |
テキストの変更 | TextChangedArgs | ターゲット要素のテキストが変更されたときにトリガーされます。 |
フォーカスの取得 | EmptyArgs | ターゲット要素がフォーカスを取得したときにトリガーされます。 |
フォーカスの喪失 | EmptyArgs | ターゲット要素がフォーカスを失ったときにトリガーされます。 |
ステートの変更 | StateChangedArgs | ターゲット要素のステートが変更されたときにトリガーされます。
注: このイベントは、ウィンドウのステートに何らかの変更 (有効化、無効化、選択、選択解除、フォーカス可能、フォーカス、表示など) があった場合にトリガーされます。ステートの新しい値は、引数の変数で公開されます。
|
選択の変更 | SelectionChangedArgs | ターゲット要素の選択値が変更されたときにトリガーされます。 |
予定の種類 | TriggerEventArgs の種類 | 説明 |
---|---|---|
出現 | EmptyArgs | ターゲット要素が出現したときにトリガーされます。 |
消滅 | EmptyArgs | ターゲット要素が消滅したときにトリガーされます。 |
テキストの変更 | TextChangedArgs | ターゲット要素のテキストが変更されたときにトリガーされます。 |
キーの押下 | JavaKeyPressArgs | ターゲット要素内にフォーカスがある状態でキーが押下されたときにトリガーされます。 |
クリック | JavaMouseActionArgs | ターゲット要素がクリックされたときにトリガーされます。 |
マウスの移動 | JavaMouseMotionArgs | ターゲット要素上にマウスが移動されたときにトリガーされます。 |
フォーカスの取得 | EmptyArgs | ターゲット要素がフォーカスを取得したときにトリガーされます。 |
フォーカスの喪失 | EmptyArgs | ターゲット要素がフォーカスを失ったときにトリガーされます。 |
有効 | EmptyArgs | ターゲット要素が有効化されたときにトリガーされます。 |
無効 | EmptyArgs | ターゲット要素が無効化されたときにトリガーされます。 |
選択の変更 | SelectionChangedArgs | ターゲット要素の選択値が変更されたときにトリガーされます。 |
マウスの到達 | JavaMouseMotionArgs | ターゲット要素の表示領域にマウスが到達したときにトリガーされます。 |
マウスの離れ | JavaMouseMotionArgs | ターゲット要素の表示領域からマウスが離れたときにトリガーされます。 |
セルの選択 | JavaCellSelectedArgs | ターゲット要素が表のセルであり、そのセルが選択されたときにトリガーされます。 |
セル値の変更 | JavaCellValueChangedArgs | ターゲット要素が表のセルであり、そのセルの値が変更されたときにトリガーされます。 |
マウス ボタンの押下 | JavaMouseActionArgs | ターゲット要素上でマウス ボタンのいずれかが押されたときにトリガーされます。 |
マウス ボタンの解放 | JavaMouseActionArgs | ターゲット要素上でマウス ボタンのいずれかが離されたときにトリガーされます。 |
メニューの選択 | EmptyArgs | ターゲット要素がメニューであり、そのメニューが選択されたときにトリガーされます。 |
メニューの選択解除 | EmptyArgs | ターゲット要素がメニューであり、そのメニューの選択が解除されたときにトリガーされます。 |
メニューのキャンセル | EmptyArgs | ターゲット要素がメニューであり、そのメニューがキャンセルされたときにトリガーされます。 |
ポップアップ メニューの表示 | EmptyArgs | ターゲット要素がポップアップ メニューであり、そのポップアップ メニューが表示されたときにトリガーされます。 |
ポップアップ メニューの非表示 | EmptyArgs | ターゲット要素がポップアップ メニューであり、そのポップアップ メニューが非表示になったときにトリガーされます。 |
ポップアップ メニューのキャンセル | EmptyArgs | ターゲット要素がポップアップ メニューであり、そのポップアップ メニューがキャンセルされたときにトリガーされます。 |
- ネイティブの埋め込みブラウザー (Slack、Discord、Electron など) での WEBCTRL ベースのネイティブ イベント
予定の種類 | TriggerEventArgs の種類 | 説明 |
---|---|---|
出現 | EmptyArgs | ターゲット要素が出現したときにトリガーされます。 |
消滅 | EmptyArgs | ターゲット要素が消滅したときにトリガーされます。 |
テキストの変更 | TextChangedArgs | ターゲット要素のテキストが変更されたときにトリガーされます。 |
キーの押下 | WebKeyPressArgs | ターゲット要素内にフォーカスがある状態でキーが押下されたときにトリガーされます。 |
クリック | WebMouseEventArgs | ターゲット要素がクリックされたときにトリガーされます。 |
ダブル クリック | WebMouseEventArgs | ターゲット要素がダブルクリックされたときにトリガーされます。 |
右クリック | WebMouseEventArgs | ターゲット要素が右クリックされたときにトリガーされます。 |
マウスの移動 | WebMouseEventArgs | ターゲット要素上にマウスが移動されたときにトリガーされます。 |
マウス ボタンの押下 | WebMouseEventArgs | ターゲット要素上でマウス ボタンのいずれかが押されたときにトリガーされます。 |
マウス ボタンの解放 | WebMouseEventArgs | ターゲット要素上でマウス ボタンのいずれかが離されたときにトリガーされます。 |
マウスの到達 | WebMouseEventArgs | ターゲット要素の表示領域にマウスが到達したときにトリガーされます。 |
マウスの離れ | WebMouseEventArgs | ターゲット要素の表示領域からマウスが離れたときにトリガーされます。 |
フォーカスの取得 | EmptyArgs | ターゲット要素がフォーカスを取得したときにトリガーされます。 |
フォーカスの喪失 | EmptyArgs | ターゲット要素がフォーカスを失ったときにトリガーされます。 |
テキスト選択の変更 | WebTextSelectionChangedArgs | ターゲット要素の選択したテキストが変更されたときにトリガーされます。 |
app
属性のみを持つ <html>
セレクターによって識別される Web アプリケーションでのみサポートされます。
ダウンロードのステートの変更
タブのアクティブ化
タブの作成
タブの削除
タブの更新
<html>
部が含まれている場合にのみ許可されます (例: <html app='chrome.exe' />
)。その他の属性 (title
、url
など) は使用できません。ウィンドウ セレクターに app
以外の属性が含まれている場合は、実行時エラーが生成されます。
[厳密セレクター] は空である必要があります。
これらの種類のイベントは、埋め込みブラウザーではサポートされていません。
イベントの種類 | TriggerEventArgs の種類 | 説明 |
---|---|---|
ダウンロードのステートの変更 | DownloadChangedArgs | DownloadItem のいずれかのプロパティが変更されたときにトリガーされます。
|
タブのアクティブ化 | TabActivatedArgs |
ウィンドウのアクティブなタブが変更されたときにトリガーされます。 注: このイベントが発生した時点ではタブの URL が設定されていない場合がありますが、
onUpdated イベントをリッスンして、URL が設定されたときに通知を受け取ることができます。
|
タブの作成 | TabCreatedArgs |
タブが作成されたときにトリガーされます。 注: このイベントが発生した時点では、タブの URL やタブ グループ メンバーシップが設定されていない可能性がありますが、
onUpdated イベントをリッスンして、URL が設定されたりタブがタブ グループに追加されたりしたときに通知を受け取ることができます。
|
タブの削除 | TabRemovedArgs | タブが閉じられたときにトリガーされます。 |
タブの更新 | TabUpdatedArgs | タブが更新されたときにトリガーされます。 |
タブ ナビゲーションの開始 | TabNavigationStartedArgs | 特定の URL へのタブ ナビゲーションが開始されたときにトリガーされるイベントです。 |
タブ ナビゲーションの終了 | TabNavigationCompletedArgs | 特定の URL へのタブ ナビゲーションが完了したときにトリガーされます。 |
ウィンドウのフォーカスの変更 | HtmlWindowFocusChangedArgs | 現在フォーカスされているウィンドウが変更されたときにトリガーされます。 |
ウィンドウの境界の変更 | HtmlWindowBoundsChangedArgs | ウィンドウのサイズが変更されたときにトリガーされます。これは、新しい境界が確定されたときにのみディスパッチされ、進行中の変更にはディスパッチされません。 |
ウィンドウの作成 | HtmlWindowCreatedArgs | ウィンドウが作成されたときにトリガーされます。 |
ウィンドウの削除 | HtmlWindowRemovedArgs | ウィンドウが削除された (閉じられた) ときにトリガーされます。 |
予定の種類 | TriggerEventsArgs の型 | 説明 |
---|---|---|
出現 | EmptyArgs | ターゲット要素が出現したときにトリガーされます。 |
消滅 | EmptyArgs | ターゲット要素が消滅したときにトリガーされます。 |
キーの押下 | KeyPressArgs | ターゲット要素内にフォーカスがある状態でキーが押下されたときにトリガーされます。 |
クリック | MouseClickedArgs | ターゲット要素がクリックされたときにトリガーされます。 |
テキストの変更 | TextChangedArgs | ターゲット要素のテキストが変更されたときにトリガーされます。 |
テキスト選択の変更 | UiaTextSelectionChangedArgs | ターゲット要素の選択したテキストが変更されたときにトリガーされます。 |
フォーカスの取得 | EmptyArgs | ターゲット要素がフォーカスを取得したときにトリガーされます。 |
フォーカスの喪失 | EmptyArgs | ターゲット要素がフォーカスを失ったときにトリガーされます。 |
呼び出し | EmptyArgs | ターゲット要素が呼び出されたときにトリガーされます。 |
選択済み | SelectionChangedArgs | ターゲット要素が選択されたときにトリガーされます。 |
選択解除 | SelectionChangedArgs | ターゲット要素の選択が解除されたときにトリガーされます。 |
切り替え | UiaToggledArgs | ターゲット要素が切り替えられたときにトリガーされます。 |
トリガーの引数
args
クラスの基底クラスです。
プロパティ | 入力 | 説明 |
---|---|---|
TriggerName | 文字列 | このイベントを生成したトリガー アクティビティの名前です (アクティビティ名として表示されます)。 |
TriggerType | 入力 | このイベントを生成したトリガー アクティビティの .NET 型です。 |
UiElementTriggerArgs
TriggerArgs
> UiElementTriggerArgs
プロパティ | 入力 | 説明 |
Selector | 文字列 | ターゲット要素のセレクターです。 |
TargetElement | UI 要素 | 監視対象のターゲット要素です。 |
NativeTriggerBaseArgs
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
プロパティ | 入力 | 説明 |
---|---|---|
SelectorIndex | Integer | ターゲット要素セレクターのインデックスです。 |
EmptyArgs
- 出現
- 消滅
- フォーカスの取得
- フォーカスの喪失
- 有効
- 無効
- メニューの選択
- メニューの選択解除
- メニューのキャンセル
- ポップアップ メニューの表示
- ポップアップ メニューの非表示
- ポップアップ メニューのキャンセル
TriggerArgs
> UiElementTriggerArgs
> EmptyArgs
TextChangedArg
- テキストの変更
- タイトルの変更
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> TextChangedArgs
プロパティ | 入力 | 説明 |
---|---|---|
Text | 文字列 | ターゲット要素の新しいテキストです。 |
StateChangedArgs
- ステートの変更
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> StateChangedArgs
プロパティ | 入力 | 説明 |
---|---|---|
State | 文字列 | ターゲット要素の新しいステートです。 |
SelectionChangedArgs
- 選択の変更
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> SelectionChangedArgs
プロパティ | 入力 | 説明 |
---|---|---|
Selection | 文字列 | ターゲット要素の新しい選択です。 |
LocationChangedArgs
- 場所の変更
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> LocationChangedArgs
プロパティ | 入力 | 説明 |
---|---|---|
Location |
矩形領域 | 変更された場所の四角形。要素のサイズとその位置に関する情報が含まれます。 |
HwndArgs
- 最前面に表示
- 背面に表示
- 最小化
- 復元
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> HwndArgs
プロパティ | 入力 | 説明 |
---|---|---|
Hwnd | Intptr | ウィンドウ ハンドルです。 |
HwndAsString | 文字列 | ウィンドウ ハンドル (文字列) です。 |
KeyPressArgs
- キーの押下
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> KeyPressArgs
プロパティ | 入力 | 説明 |
---|---|---|
Key | Integer | 操作されたキーです。 |
ScanCode | Integer | 操作されたキーに対応するスキャン コードです。 |
KeyAction | Integer | キーが押されたか、それとも解放されたかを示します。予想される値:
|
KeyModifiers | NKeyModifiers | キーと共に使用されたキー修飾子。予想される値:
|
MouseClickedArgs
- クリック
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> MouseClickedArgs
プロパティ | 入力 | 説明 |
---|---|---|
X | Integer | マウス ポインターの X 座標です。 |
Y | Integer | マウス ポインターの Y 座標です。 |
MouseButton | Integer | クリックされたマウス ボタン。予想される値:
|
MouseAction | Integer | マウス ボタンが押されたか、それとも解放されたかを示します。予想される値:
|
KeyModifiers | NKeyModifiers | マウス ボタンと共に使用されたキー修飾子。予想される値:
|
JavaKeyPressArgs
Java の以下のイベントからデータを返します。
- キーの押下
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> JavaKeyPressArgs
プロパティ | 入力 | 説明 |
---|---|---|
KeyChar | 文字列 | 押されたキーに対応する文字です。 |
KeyCode | Integer | 押されたキーに対応するコードです。 |
ExtendedKeyCode | Integer | 押されたキーの拡張キー・コード。KeyCode とは異なり、この値は現在のキーボード レイアウトによって異なります。
|
Location | 文字列 | イベントを発生させたキーの位置です。 |
KeyModifiers | NKeyModifiers | キーと共に使用されたキー修飾子。予想される値:
|
JavaMouseActionArgs
Java の以下のイベントからデータを返します。
- クリック
- マウス ボタンの押下
- マウス ボタンの解放
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> JavaMouseActionArgs
プロパティ | 入力 | 説明 |
---|---|---|
X | Integer | マウス ポインターの X 座標です。 |
Y | Integer | マウス ポインターの Y 座標です。 |
Button | Integer | クリックされたマウス ボタン。予想される値:
|
ClickCount | Integer | ボタンがクリックされた回数です。 |
KeyModifiers | NKeyModifiers | マウス ボタンと共に使用されたキー修飾子。予想される値:
|
JavaMouseMotionArgs
Java の以下のイベントからデータを返します。
- マウスの移動
- マウスの到達
- マウスの離れ
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> JavaMouseMotionArgs
プロパティ | 入力 | 説明 |
---|---|---|
X | Integer | マウス ポインターの X 座標です。 |
Y | Integer | マウス ポインターの Y 座標です。 |
MouseButton | Integer | クリックされたマウス ボタン。予想される値:
|
JavaCellSelectedArgs
- クリック
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> JavaCellSelectedArgs
プロパティ | 入力 | 説明 |
---|---|---|
Row | Integer | 選択されたセルの行です。 |
Column | Integer | 選択されたセルの列です。 |
JavaCellValueChangedArgs
- クリック
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> JavaCellValueChangedArgs
プロパティ | 入力 | 説明 |
---|---|---|
Row | Integer | セルの行です。 |
Column | Integer | セルの列です。 |
Value | 文字列 | セルの新しい値です。 |
WebMouseEventArgs
- クリック
- ダブル クリック
- 右クリック
- マウスの移動
- マウスの到達
- マウスの離れ
- マウス ボタンの押下
- マウス ボタンの解放
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> WebMouseEventArgs
プロパティ | 入力 | 説明 |
---|---|---|
AltKey | Boolean | Alt キーが押されたかどうかです。 |
Button | Integer | どのマウス ボタンが押されたか。予想される値:
|
ClientX | Integer | マウス ポインターの X 座標 (ウィンドウを基準にした相対座標) です。 |
ClientY | Integer | マウス ポインターの Y 座標 (ウィンドウを基準にした相対座標) です。 |
CtrlKey | Boolean | Ctrl キーが押されたかどうかです。 |
MetaKey | Boolean | メタ キーが押されたかどうかです。 |
MovementX | Integer | マウス ポインターの X 座標 (最後の mousemove イベントの位置を基準にした相対座標) です。
|
MovementY | Integer | マウス ポインターの Y 座標 (最後の mousemove イベントの位置を基準にした相対座標) です。
|
OffsetX | Integer | マウス ポインターの X 座標 (ターゲットを基準にした相対座標) です。 |
OffsetY | Integer | マウス ポインターの Y 座標 (ターゲットを基準にした相対座標) です。 |
PageX | Integer | マウス ポインターの X 座標 (ドキュメントを基準にした相対座標) です。 |
PageY | Integer | マウス ポインターの Y 座標 (ドキュメントを基準にした相対座標) です。 |
ScreenX | Integer | マウス ポインターの X 座標 (画面を基準にした相対座標) です。 |
ScreenY | Integer | マウス ポインターの Y 座標 (画面を基準にした相対座標) です。 |
ShiftKey | Boolean | Shift キーが押されたかどうかです。 |
WebKeyPressArgs
- キーの押下
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> WebKeyPressArgs
プロパティ | 入力 | 説明 |
---|---|---|
AltKey | Boolean | Alt キーが押されたかどうかです。 |
Code | 文字列 | イベントをトリガーしたキーのコードです (例: KeyA 、KeyB 、ControlLeft 、ControlRight )。
|
CtrlKey | Boolean | Ctrl キーが押されたかどうかです。 |
IsComposing | Boolean | イベントのステートが変換中かどうかです。 |
Key | 文字列 | イベントをトリガーしたキーの値です (例: a 、b 、Control )
|
Location | Integer | キーボードまたはデバイス上のキーの場所。予想される値:
|
MetaKey | Boolean | メタ キーが押されたかどうかです。 |
Repeat | Boolean | キーが繰り返し押されたままになっているかどうかです。 |
ShiftKey | Boolean | Shift キーが押されたかどうかです。 |
WebTextSelectionChangedArgs
- テキスト選択の変更
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> WebTextSelectionChangedArgs
プロパティ | 入力 | 説明 |
---|---|---|
AnchorClientBounds | 矩形領域 | アンカー クライアントの境界: 要素のサイズおよびビューポートを基準とした位置に関する情報。 |
AnchorElement | UI 要素 | アンカーの UI 要素です。 |
AnchorOffset | Integer | (ターゲット要素のフル テキストから) テキストの選択が開始された文字の 0 ベースのインデックスです。 |
FocusClientBounds | 矩形領域 | フォーカス クライアントの境界とは、要素のサイズとビューポートを基準とした位置に関する情報です。 |
FocusElement | UI 要素 | フォーカスがある UI 要素です。 |
FocusOffset | Integer | (ターゲット要素のフル テキストから) テキストの選択が終了された文字の、0 ベースのインデックスです。 |
SelectedText | 文字列 | ターゲット要素の新しいテキストの選択です。 |
DownloadChangedArgs
- ダウンロードのステートの変更
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> DownloadChangedArgs
プロパティ | 入力 | 説明 |
---|---|---|
State | 文字列 | downloads.DownloadItem の state の変更を説明する文字列です。
|
Id | 文字列 | 変更された downloads.DownloadItem の id です。
|
FileName | 文字列 | downloads.DownloadItem の url の変更を説明する文字列です。
|
Url | 文字列 | downloads.DownloadItem の filename の変更を説明する文字列です。
|
StartTime | 文字列 | downloads.DownloadItem の startTime の変更を説明する文字列です。
|
EndTime | 文字列 | downloads.DownloadItem の endTime の変更を説明する文字列です。
|
Error | 文字列 | downloads.DownloadItem の error ステータスの変更を説明する文字列です。
|
TabActivatedArgs
WEBCTRL の以下のイベントからデータを返します。
- タブのアクティブ化
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> TabActivatedArgs
プロパティ | 入力 | 説明 |
---|---|---|
TabId | 文字列 | アクティブ化されたタブの ID です。 |
WindowId | 文字列 | 選択されたタブが変更されたウィンドウの ID です。 |
Title | 文字列 | タブの新しいタイトルです。 |
Url | 文字列 | タブの URL (変更された場合) |
TabCreatedArgs
- タブの作成
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> TabCreatedArgs
プロパティ | 入力 | 説明 |
---|---|---|
TabId | 文字列 | 作成されたタブの ID です。 |
WindowId | 文字列 | タブを含むウィンドウの ID です。 |
Title | 文字列 | タブの新しいタイトルです。 |
Url | 文字列 | タブの URL です。 |
TabRemovedArgs
- タブの削除
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> TabRemovedArgs
プロパティ | 入力 | 説明 |
---|---|---|
TabId | 文字列 | 削除されたタブの ID です。 |
WindowId | 文字列 | タブを閉じるウィンドウの ID です。 |
IsWindowClosing | Boolean | True 親ウィンドウが閉じられたためタブが閉じられた場合
|
TabUpdatedArgs
- タブの更新
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> TabUpdatedArgs
プロパティ | 入力 | 説明 |
---|---|---|
TabId | 文字列 | 更新されたタブの ID です。 |
WindowId | 文字列 | タブを含むウィンドウの ID です。 |
Status | 文字列 | タブの読み込みステータスです。 |
Title | 文字列 | タブの新しいタイトルです。 |
Url | 文字列 | タブの URL (変更された場合) |
Active | Boolean | タブがウィンドウでアクティブかどうかを示します。必ずしもこのウィンドウにフォーカスがあるわけではありません。 |
TabNavigationStartedArgs
- タブ ナビゲーションの開始
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> TabNavigationStartedArgs
プロパティ | 入力 | 説明 |
---|---|---|
Url | 文字列 | フレームに現在関連付けられている URL (FrameId によって識別されるフレームが、指定されたタブ内のあるポイントに存在していた場合)。URL が特定の FrameId に関連付けられていても、対応するフレームが依然として存在するとは限りません。
|
TabId | Integer | フレームが存在するタブの ID。 |
FrameId | Integer |
開始イベントが実行され、タブ ナビゲーションが発生したタブ内のフレームの ID。 フレームは、
TabId と FrameId によって一意に識別されます。
|
TimeStampMs | Double |
タブ ナビゲーションが開始された時刻 (エポックからのミリ秒単位)。 Web ナビゲーションのイベントの
TimeStampMs プロパティは、内部的に一貫性があることのみが保証されます。あるイベントを別のイベントと比較すると、イベント間の正しいオフセットが得られますが、拡張機能内の現在の時刻 ((new Date()).getTime() など) と比較すると、予期しない結果が生じる可能性があります。
|
DateTime | 日付 | タブ ナビゲーションが開始された日時 (UTC)。 |
TabNavigationCompletedArgs
- タブ ナビゲーションの終了
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> TabNavigationCompletedArgs
プロパティ | 入力 | 説明 |
---|---|---|
Url | 文字列 | フレームに現在関連付けられている URL です (FrameId によって識別されるフレームが、指定されたタブ内にある時点で存在していた場合)。URL が特定の FrameId に関連付けられていても、対応するフレームが依然として存在するとは限りません。
|
TabId | Integer | フレームが存在するタブの ID です。 |
FrameId | Integer |
完了したイベントが発生し、タブ ナビゲーションが発生したタブ内のフレームの ID です。 フレームは、
TabId と FrameId によって一意に識別されます。
|
TimeStampMs | Double |
タブ ナビゲーションが完了した時刻 (エポックからのミリ秒単位)。 Web ナビゲーションのイベントの
TimeStampMs プロパティは、内部的に一貫性があることのみが保証されます。あるイベントを別のイベントと比較すると、イベント間の正しいオフセットが得られますが、拡張機能内の現在の時刻 ((new Date()).getTime() など) と比較すると、予期しない結果が生じる可能性があります。
|
DateTime | 日付 | タブ ナビゲーションが完了した日時 (UTC)。 |
HtmlWindowFocusChangedArgs
- ウィンドウのフォーカスの変更
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> HtmlWindowFocusChangedArgs
プロパティ | 入力 | 説明 |
---|---|---|
TabId | 文字列 | 新しくフォーカスされたタブの ID。 |
WindowId | 文字列 | タブを含むウィンドウの ID です。 |
Title | 文字列 | タブのタイトルです。 |
Url | 文字列 | タブの URL (変更された場合) |
HtmlWindowBoundsChangedArgs
- ウィンドウの境界の変更
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> HtmlWindowBoundsChangedArgs
プロパティ | 入力 | 説明 |
---|---|---|
WindowId | 文字列 | 境界が変更されたウィンドウの ID。 |
Focused | Boolean | ウィンドウが現在フォーカスされているウィンドウかどうか。 |
Top | Integer | 画面の上端からのウィンドウのオフセット (ピクセル単位)。 |
Left | Integer | 画面の左端からのウィンドウのオフセット (ピクセル単位) です。 |
Width | Integer | フレームを含むウィンドウの幅 (ピクセル単位)。 |
Height | Integer | フレームを含むウィンドウの高さです (ピクセル単位)。 |
HtmlWindowCreatedArgs
- ウィンドウの作成
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> HtmlWindowCreatedArgs
プロパティ | 入力 | 説明 |
---|---|---|
WindowId | 文字列 | 作成されたウィンドウの ID。 |
HtmlWindowRemovedArgs
- ウィンドウの削除
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> HtmlWindowRemovedArgs
プロパティ | 入力 | 説明 |
---|---|---|
WindowId | 文字列 | 削除されたウィンドウの ID です。 |
UiaToggledArgs
- 「切り替え」イベント
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> UiaToggledArgs
プロパティ | 入力 | 説明 |
---|---|---|
State | 文字列 | ターゲット要素の新しいステートです。 |
UiaTextSelectionChangedArgs
- テキスト選択の変更イベント
TriggerArgs
> UiElementTriggerArgs
> NativeTriggerBaseArgs
> UiaTextSelectionChangedArgs
プロパティ | 入力 | 説明 |
---|---|---|
TextRanges | UiaTextRange() |
ターゲット要素内の選択したテキスト要素に関するさまざまな情報を保持する配列 (隣接していないテキストが選択されている場合は、複数のテキスト要素が選択されることがあります)。 この配列の各アイテムは、次の情報を示します。
|
トリガーベースの有人オートメーションのコンテキストでは、イベント検査ツールを使用して、アプリケーション内の特定の UI 要素を操作したときにトリガーされるネイティブ イベントの種類を識別し、[アプリケーション イベント トリガー] アクティビティを設定することができます。このツールは、クリック、キーの押下、フォーカスの取得、フォーカスの喪失、その他の関連する操作など、選択したすべての種類のイベントをキャプチャして監視します。それにより、実行されたアクションを分析し、発生した問題を診断することができます。
有効な UI 要素が選択されている状態で [イベントを検査] ツールバー ボタンをクリックすると、UI Explorer からイベント検査ツールを開くことができます。
- 記録 - UI 要素を操作することによって生成されたイベントが記録され、イベント リストに追加されます。
- 一時停止 - UI 要素を操作したときにその UI 要素によって生成されるイベントが記録されなくなります。
- 強調表示 - ターゲット要素の輪郭を表示し、数秒間前面に移動します。強調表示は無効化されるまでオンのままになります。
- UI Explorer で開く - 監視対象の要素が UI Explorer で開き、その要素のセレクターを確認できます。
- クリア - 記録されたすべてのイベントを削除します。
- CSV - キャプチャしたイベントを
.csv
ファイルにエクスポートして、さらに詳しく分析することができます。
- イベント フィルター - ターゲット要素に対して監視するイベントの種類を選択できます。
- イベント リスト - キャプチャしたイベントに関する情報を表示します。
特定の種類のイベントをフィルタリングしてキャプチャするには、イベントの種類のリストでチェックボックスをオンまたはオフにします。リストは、選択した要素のテクノロジによって異なる場合があります。
Web または Java UI 要素に固有のあらゆる種類のマウス イベント (マウスの移動、マウスの押下、マウスの解放、マウスの到達、マウスの離れ) は、イベント リストが増大する可能性があるため、既定では無効になっています。そうした種類のマウス イベントを有効化するのは、特に監視が必要な場合だけにすることをお勧めします。
また、イベントの記録の開始後にも、そうした種類のイベントを有効化または無効化できます。
- イベント名 - イベントの種類です。
- タイム スタンプ - イベントが実行された日付と時間です。
- イベント データ - 特定のイベントに関するデータとパラメーターです。
.csv
ファイルへのエクスポートのみです。監視を再開するには、ウィンドウを閉じて、イベント検査ツールの別のインスタンスを開きます。