アプリケーション イベント トリガー

UiPath.UIAutomationNext.Activities.NNativeEventTrigger

説明

任意の種類の要素 (トップレベル ウィンドウやその他の指定した UI 要素) のネイティブ イベントに基づいてトリガーを設定します。画面上でターゲット要素を指定し、その要素でサポートされているイベントのリストからネイティブ イベントを選択できます。

このアクティビティはオブジェクト リポジトリに対応しています。

トリガーはワークフローの最初のアクティビティである必要があります。ワークフローは、特定の UI イベントが発生するとトリガーされます。ワークフローごとに許可されるトリガーは 1 つのみです。詳しくは、「トリガーベースの有人オートメーション」をご覧ください。

注:

2023.4 より前のバージョンの Studio を使用している場合、[アプリケーション イベント トリガー] アクティビティを [トリガー スコープ] アクティビティ内に配置する必要があります。この場合、[アプリケーション イベント トリガー] アクティビティの [スケジュール モード] プロパティと [有効] プロパティは表示されません。[トリガー スコープ] アクティビティの [スケジュール モード] プロパティが利用可能です。

プロジェクトの対応 OS

Windows - レガシ | Windows

Windows - レガシ、Windows での設定

デザイナー パネル

• [画面上でターゲットを指定] をクリックして、ターゲットとして使用する 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 のネイティブ イベント

WND イベント - トップレベル ウィンドウ

予定の種類	TriggerEventArgs の種類	説明
出現	EmptyArgs	ターゲット要素が出現したときにトリガーされます。
消滅	EmptyArgs	ターゲット要素が消滅したときにトリガーされます。
タイトルの変更	TextChangedArgs	ターゲット要素のタイトルが変更されたときにトリガーされます。 注: これは、[テキストの変更] イベントです。トップレベル ウィンドウについては、明確化するため、名前が [タイトルの変更] に変更されました。
ステートの変更	StateChangedArgs	ターゲット要素のステートが変更されたときにトリガーされます。 注: このイベントは、ウィンドウのステートに何らかの変更 (有効化、無効化、選択、選択解除、フォーカス可能、フォーカス、表示など) があった場合にトリガーされます。ステートの新しい値は、引数の変数で公開されます。
場所の変更	LocationChangedArgs	ターゲット要素の場所が変更されたときにトリガーされます。
最前面に表示	HwndArgs	ターゲット要素のウィンドウがフォアグラウンド ウィンドウになったときにトリガーされます。
背面に表示	HwndArgs	ターゲット要素のウィンドウが最前面に表示されなくなったときにトリガーされます。
最小化	HwndArgs	ターゲット要素のウィンドウが最小化されようとしているときにトリガーされます。
復元	HwndArgs	ターゲット要素のウィンドウが復元されようとしているときにトリガーされます。

CTRL または WND イベント - UI 要素

予定の種類	TriggerEventArgs の種類	説明
出現	EmptyArgs	ターゲット要素が出現したときにトリガーされます。
消滅	EmptyArgs	ターゲット要素が消滅したときにトリガーされます。
キーの押下	KeyPressArgs	ターゲット要素内にフォーカスがある状態でキーが押下されたときにトリガーされます。
クリック	MouseClickedArgs	ターゲット要素がクリックされたときにトリガーされます。
テキストの変更	TextChangedArgs	ターゲット要素のテキストが変更されたときにトリガーされます。
フォーカスの取得	EmptyArgs	ターゲット要素がフォーカスを取得したときにトリガーされます。
フォーカスの喪失	EmptyArgs	ターゲット要素がフォーカスを失ったときにトリガーされます。
ステートの変更	StateChangedArgs	ターゲット要素のステートが変更されたときにトリガーされます。 注: このイベントは、ウィンドウのステートに何らかの変更 (有効化、無効化、選択、選択解除、フォーカス可能、フォーカス、表示など) があった場合にトリガーされます。ステートの新しい値は、引数の変数で公開されます。
選択の変更	SelectionChangedArgs	ターゲット要素の選択値が変更されたときにトリガーされます。

JAVA イベント - UI 要素

予定の種類	TriggerEventArgs の種類	説明
出現	EmptyArgs	ターゲット要素が出現したときにトリガーされます。
消滅	EmptyArgs	ターゲット要素が消滅したときにトリガーされます。
テキストの変更	TextChangedArgs	ターゲット要素のテキストが変更されたときにトリガーされます。
キーの押下	JavaKeyPressArgs	ターゲット要素内にフォーカスがある状態でキーが押下されたときにトリガーされます。
クリック	JavaMouseActionArgs	ターゲット要素がクリックされたときにトリガーされます。
マウスの移動	JavaMouseMotionArgs	ターゲット要素上にマウスが移動されたときにトリガーされます。
フォーカスの取得	EmptyArgs	ターゲット要素がフォーカスを取得したときにトリガーされます。
フォーカスの喪失	EmptyArgs	ターゲット要素がフォーカスを失ったときにトリガーされます。
有効	EmptyArgs	ターゲット要素が有効化されたときにトリガーされます。
無効	EmptyArgs	ターゲット要素が無効化されたときにトリガーされます。
選択の変更	SelectionChangedArgs	ターゲット要素の選択値が変更されたときにトリガーされます。
マウスの到達	JavaMouseMotionArgs	ターゲット要素の表示領域にマウスが到達したときにトリガーされます。
マウスの離れ	JavaMouseMotionArgs	ターゲット要素の表示領域からマウスが離れたときにトリガーされます。
セルの選択	JavaCellSelectedArgs	ターゲット要素が表のセルであり、そのセルが選択されたときにトリガーされます。
セル値の変更	JavaCellValueChangedArgs	ターゲット要素が表のセルであり、そのセルの値が変更されたときにトリガーされます。
マウス ボタンの押下	JavaMouseActionArgs	ターゲット要素上でマウス ボタンのいずれかが押されたときにトリガーされます。
マウス ボタンの解放	JavaMouseActionArgs	ターゲット要素上でマウス ボタンのいずれかが離されたときにトリガーされます。
メニューの選択	EmptyArgs	ターゲット要素がメニューであり、そのメニューが選択されたときにトリガーされます。
メニューの選択解除	EmptyArgs	ターゲット要素がメニューであり、そのメニューの選択が解除されたときにトリガーされます。
メニューのキャンセル	EmptyArgs	ターゲット要素がメニューであり、そのメニューがキャンセルされたときにトリガーされます。
ポップアップ メニューの表示	EmptyArgs	ターゲット要素がポップアップ メニューであり、そのポップアップ メニューが表示されたときにトリガーされます。
ポップアップ メニューの非表示	EmptyArgs	ターゲット要素がポップアップ メニューであり、そのポップアップ メニューが非表示になったときにトリガーされます。
ポップアップ メニューのキャンセル	EmptyArgs	ターゲット要素がポップアップ メニューであり、そのポップアップ メニューがキャンセルされたときにトリガーされます。

WEBCTRL のイベント - UI 要素

注:

UiPath.UIAutomation.Activities v23.10.3 から、以下のサポートが追加されました。

• ネイティブの埋め込みブラウザー (Slack、Discord、Electron など) での WEBCTRL ベースのネイティブ イベント

予定の種類	TriggerEventArgs の種類	説明
出現	EmptyArgs	ターゲット要素が出現したときにトリガーされます。
消滅	EmptyArgs	ターゲット要素が消滅したときにトリガーされます。
テキストの変更	TextChangedArgs	ターゲット要素のテキストが変更されたときにトリガーされます。
キーの押下	WebKeyPressArgs	ターゲット要素内にフォーカスがある状態でキーが押下されたときにトリガーされます。
クリック	WebMouseEventArgs	ターゲット要素がクリックされたときにトリガーされます。
ダブル クリック	WebMouseEventArgs	ターゲット要素がダブルクリックされたときにトリガーされます。
右クリック	WebMouseEventArgs	ターゲット要素が右クリックされたときにトリガーされます。
マウスの移動	WebMouseEventArgs	ターゲット要素上にマウスが移動されたときにトリガーされます。
マウス ボタンの押下	WebMouseEventArgs	ターゲット要素上でマウス ボタンのいずれかが押されたときにトリガーされます。
マウス ボタンの解放	WebMouseEventArgs	ターゲット要素上でマウス ボタンのいずれかが離されたときにトリガーされます。
マウスの到達	WebMouseEventArgs	ターゲット要素の表示領域にマウスが到達したときにトリガーされます。
マウスの離れ	WebMouseEventArgs	ターゲット要素の表示領域からマウスが離れたときにトリガーされます。
フォーカスの取得	EmptyArgs	ターゲット要素がフォーカスを取得したときにトリガーされます。
フォーカスの喪失	EmptyArgs	ターゲット要素がフォーカスを失ったときにトリガーされます。
テキスト選択の変更	WebTextSelectionChangedArgs	ターゲット要素の選択したテキストが変更されたときにトリガーされます。

HTML イベント - UI 要素

注: 以下の種類のイベントは、app 属性のみを持つ <html> セレクターによって識別される Web アプリケーションでのみサポートされます。

• ダウンロードのステートの変更
• タブのアクティブ化
• タブの作成
• タブの削除
• タブの更新

現在のところ、これらのイベントは、Window セレクターに <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	ウィンドウが削除された (閉じられた) ときにトリガーされます。
Web 要求: リダイレクト前	WebRequestBeforeRedirectArgs	サーバーによって開始されたリダイレクトが発生しようとしているときにトリガーされます。
Web 要求: 要求前	WebRequestBeforeRequestArgs	要求が発生しようとしているときにトリガーされます。
Web 要求: HTTP ヘッダーの送信前	WebRequestBeforeSendHeadersArgs	要求が発生しようとしていて、初期ヘッダーが準備されたときにトリガーされます。このイベントは、拡張機能が要求ヘッダーを追加、変更、および削除できるようにすることを目的としたものです。
Web 要求: 完了時	WebRequestCompletedArgs	Web 要求が正常に処理されたときにトリガーされます。
Web 要求: エラー発生時	WebRequestErrorOccurredArgs	Web 要求が正常に処理されなかったときにトリガーされます。 Web 要求 API は、1 つの例外を除き、各要求に対して「Completed (完了)」または「Error occurred (エラー発生)」のいずれかを最終イベントとして返します。
Web 要求: HTTP ヘッダー受信時	WebRequestHeadersReceivedArgs	HTTP(S) 応答ヘッダーが受信されるたびにトリガーされます。リダイレクトと認証要求により、要求ごとに複数回トリガーされる可能性があります。
Web 要求: 応答開始時	WebRequestResponseStartedArgs	応答の本文の最初のバイトを受信したときにトリガーされます。HTTP 要求の場合、これはステータス行と応答ヘッダーが利用可能であることを意味します。このイベントは情報であり、非同期的に処理されます。要求を変更したりキャンセルしたりすることはできません。
Web 要求: HTTP ヘッダー送信時	WebRequestSendHeadersArgs	すべての拡張機能が要求ヘッダーを変更できた後にトリガーされ、最終バージョンを示します。このイベントは、ヘッダーがネットワークに送信される前にトリガーされます。このイベントは情報であり、非同期的に処理されます。要求を変更したりキャンセルしたりすることはできません。

UIA イベント - UI 要素

予定の種類	TriggerEventsArgs の型	説明
出現	EmptyArgs	ターゲット要素が出現したときにトリガーされます。
消滅	EmptyArgs	ターゲット要素が消滅したときにトリガーされます。
キーの押下	KeyPressArgs	ターゲット要素内にフォーカスがある状態でキーが押下されたときにトリガーされます。
クリック	MouseClickedArgs	ターゲット要素がクリックされたときにトリガーされます。
テキストの変更	TextChangedArgs	ターゲット要素のテキストが変更されたときにトリガーされます。
テキスト選択の変更	UiaTextSelectionChangedArgs	ターゲット要素の選択したテキストが変更されたときにトリガーされます。
フォーカスの取得	EmptyArgs	ターゲット要素がフォーカスを取得したときにトリガーされます。
フォーカスの喪失	EmptyArgs	ターゲット要素がフォーカスを失ったときにトリガーされます。
呼び出し	EmptyArgs	ターゲット要素が呼び出されたときにトリガーされます。
選択済み	SelectionChangedArgs	ターゲット要素が選択されたときにトリガーされます。
選択解除	SelectionChangedArgs	ターゲット要素の選択が解除されたときにトリガーされます。
切り替え	UiaToggledArgs	ターゲット要素が切り替えられたときにトリガーされます。

TriggerEventArgs プロパティ

トリガーの引数

トリガーに関連するすべての 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

WND 要素と CTRL 要素の以下のイベントからデータを返します。

• キーの押下

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > KeyPressArgs

プロパティ	入力	説明
Key	Integer	操作されたキーです。
ScanCode	Integer	操作されたキーに対応するスキャン コードです。
KeyAction	Integer	キーが押されたか、それとも解放されたかを示します。予想される値: 0 - キーが押された 1 - キーが解放された
KeyModifiers	NKeyModifiers	キーと共に使用されたキー修飾子。予想される値: None = 0 Alt = 1 Ctrl = 2 Shift = 4 Win = 8

MouseClickedArgs

WND 要素と CTRL 要素の以下のイベントからデータを返します。

• クリック

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > MouseClickedArgs

プロパティ	入力	説明
X	Integer	マウス ポインターの X 座標です。
Y	Integer	マウス ポインターの Y 座標です。
MouseButton	Integer	クリックされたマウス ボタン。予想される値: 0 - なし 1 - 左 2 - 中央 3 - 右
MouseAction	Integer	マウス ボタンが押されたか、それとも解放されたかを示します。予想される値: 0 - マウス ボタンが押された 1 - マウス ボタンが解放された
KeyModifiers	NKeyModifiers	マウス ボタンと共に使用されたキー修飾子。予想される値: None = 0 Alt = 1 Ctrl = 2 Shift = 4 Win = 8

JavaKeyPressArgs

Java の以下のイベントからデータを返します。

• キーの押下

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaKeyPressArgs

プロパティ	入力	説明
KeyChar	文字列	押されたキーに対応する文字です。
KeyCode	Integer	押されたキーに対応するコードです。
ExtendedKeyCode	Integer	押されたキーの拡張キー・コード。KeyCode とは異なり、この値は現在のキーボード レイアウトによって異なります。
Location	文字列	イベントを発生させたキーの位置です。
KeyModifiers	NKeyModifiers	キーと共に使用されたキー修飾子。予想される値: None = 0 Alt = 1 Ctrl = 2 Shift = 4 Win = 8

JavaMouseActionArgs

Java の以下のイベントからデータを返します。

• クリック
• マウス ボタンの押下
• マウス ボタンの解放

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaMouseActionArgs

プロパティ	入力	説明
X	Integer	マウス ポインターの X 座標です。
Y	Integer	マウス ポインターの Y 座標です。
Button	Integer	クリックされたマウス ボタン。予想される値: 1 - 左 2 - 中央 3 - 右
ClickCount	Integer	ボタンがクリックされた回数です。
KeyModifiers	NKeyModifiers	マウス ボタンと共に使用されたキー修飾子。予想される値: None = 0 Alt = 1 Ctrl = 2 Shift = 4 Win = 8

JavaMouseMotionArgs

Java の以下のイベントからデータを返します。

• マウスの移動
• マウスの到達
• マウスの離れ

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaMouseMotionArgs

プロパティ	入力	説明
X	Integer	マウス ポインターの X 座標です。
Y	Integer	マウス ポインターの Y 座標です。
MouseButton	Integer	クリックされたマウス ボタン。予想される値: 0 - なし 1 - 左 2 - 中央 3 - 右

JavaCellSelectedArgs

Java の以下のイベントからデータを返します。

• クリック

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaCellSelectedArgs

プロパティ	入力	説明
Row	Integer	選択されたセルの行です。
Column	Integer	選択されたセルの列です。

JavaCellValueChangedArgs

Java の以下のイベントからデータを返します。

• クリック

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaCellValueChangedArgs

プロパティ	入力	説明
Row	Integer	セルの行です。
Column	Integer	セルの列です。
Value	文字列	セルの新しい値です。

WebMouseEventArgs

WEBCTRL の以下のイベントからデータを返します。

• クリック
• ダブル クリック
• 右クリック
• マウスの移動
• マウスの到達
• マウスの離れ
• マウス ボタンの押下
• マウス ボタンの解放

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebMouseEventArgs

注: マウス イベントに対して定義されたプロパティ名に従います。

プロパティ	入力	説明
AltKey	Boolean	Alt キーが押されたかどうかです。
Button	Integer	どのマウス ボタンが押されたか。予想される値: 0 - 左 1 - 中央 2 - 右
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

WEBCTRL の以下のイベントからデータを返します。

• キーの押下

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebKeyPressArgs

注: キーボード イベントに対して定義されたプロパティ名に従います。

プロパティ	入力	説明
AltKey	Boolean	Alt キーが押されたかどうかです。
Code	文字列	イベントをトリガーしたキーのコードです (例: KeyA、KeyB、ControlLeft、ControlRight)。
CtrlKey	Boolean	Ctrl キーが押されたかどうかです。
IsComposing	Boolean	イベントのステートが変換中かどうかです。
Key	文字列	イベントをトリガーしたキーの値です (例: a、b、Control)
Location	Integer	キーボードまたはデバイス上のキーの場所。予想される値: 0 - 標準 - キーボードのほぼすべてのキーを表す 1 - 左キーが押された 2 - 右キーが押された 3 - テンキーのキーが押された
MetaKey	Boolean	メタ キーが押されたかどうかです。
Repeat	Boolean	キーが繰り返し押されたままになっているかどうかです。
ShiftKey	Boolean	Shift キーが押されたかどうかです。

WebTextSelectionChangedArgs

WEBCTRL の以下のイベントからデータを返します。

• テキスト選択の変更

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebTextSelectionChangedArgs

注: キーボード イベントに対して定義されたプロパティ名に従います。

プロパティ	入力	説明
AnchorClientBounds	矩形領域	アンカー クライアントの境界: 要素のサイズおよびビューポートを基準とした位置に関する情報。
AnchorElement	UI 要素	アンカーの UI 要素です。
AnchorOffset	Integer	(ターゲット要素のフル テキストから) テキストの選択が開始された文字の 0 ベースのインデックスです。
FocusClientBounds	矩形領域	フォーカス クライアントの境界とは、要素のサイズとビューポートを基準とした位置に関する情報です。
FocusElement	UI 要素	フォーカスがある UI 要素です。
FocusOffset	Integer	(ターゲット要素のフル テキストから) テキストの選択が終了された文字の、0 ベースのインデックスです。
SelectedText	文字列	ターゲット要素の新しいテキストの選択です。

DownloadChangedArgs

WEBCTRL の以下のイベントからデータを返します。

• ダウンロードのステートの変更

継承: 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

WEBCTRL の以下のイベントからデータを返します。

• タブの作成

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabCreatedArgs

プロパティ	入力	説明
TabId	文字列	作成されたタブの ID です。
WindowId	文字列	タブを含むウィンドウの ID です。
Title	文字列	タブの新しいタイトルです。
Url	文字列	タブの URL です。

TabRemovedArgs

WEBCTRL の以下のイベントからデータを返します。

• タブの削除

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabRemovedArgs

プロパティ	入力	説明
TabId	文字列	削除されたタブの ID です。
WindowId	文字列	タブを閉じるウィンドウの ID です。
IsWindowClosing	Boolean	True 親ウィンドウが閉じられたためタブが閉じられた場合

TabUpdatedArgs

WEBCTRL の以下のイベントからデータを返します。

• タブの更新

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabUpdatedArgs

プロパティ	入力	説明
TabId	文字列	更新されたタブの ID です。
WindowId	文字列	タブを含むウィンドウの ID です。
Status	文字列	タブの読み込みステータスです。
Title	文字列	タブの新しいタイトルです。
Url	文字列	タブの URL (変更された場合)
Active	Boolean	タブがウィンドウでアクティブかどうかを示します。必ずしもこのウィンドウにフォーカスがあるわけではありません。

TabNavigationStartedArgs

HTML の以下のイベントからデータを返します。

• タブ ナビゲーションの開始

継承: 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

HTML の以下のイベントからデータを返します。

• タブ ナビゲーションの終了

継承: 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

HTML の以下のイベントからデータを返します。

• ウィンドウのフォーカスの変更

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowFocusChangedArgs

プロパティ	入力	説明
TabId	文字列	新しくフォーカスされたタブの ID。
WindowId	文字列	タブを含むウィンドウの ID です。
Title	文字列	タブのタイトルです。
Url	文字列	タブの URL (変更された場合)

HtmlWindowBoundsChangedArgs

HTML の以下のイベントからデータを返します。

• ウィンドウの境界の変更

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowBoundsChangedArgs

プロパティ	入力	説明
WindowId	文字列	境界が変更されたウィンドウの ID。
Focused	Boolean	ウィンドウが現在フォーカスされているウィンドウかどうか。
Top	Integer	画面の上端からのウィンドウのオフセット (ピクセル単位)。
Left	Integer	画面の左端からのウィンドウのオフセット (ピクセル単位) です。
Width	Integer	フレームを含むウィンドウの幅 (ピクセル単位)。
Height	Integer	フレームを含むウィンドウの高さです (ピクセル単位)。

HtmlWindowCreatedArgs

HTML の以下のイベントからデータを返します。

• ウィンドウの作成

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowCreatedArgs

プロパティ	入力	説明
WindowId	文字列	作成されたウィンドウの ID。

HtmlWindowRemovedArgs

HTML の以下のイベントからデータを返します。

• ウィンドウの削除

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowRemovedArgs

プロパティ	入力	説明
WindowId	文字列	削除されたウィンドウの ID です。

WebRequestBaseArgs

HTML の Web 要求イベント args の基本クラス。

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs

プロパティ	入力	説明
FrameId	文字列	要求が発生したフレームの ID。
Initiator	文字列	要求の送信元。
Method	文字列	標準の HTTP メソッド。
ParentFrameId	文字列	要求を送信したフレームをラップするフレームの ID。
RequestId	文字列	要求の ID。
TabId	文字列	要求が実行されたタブの ID。
TimeStamp	文字列	このシグナルがトリガーされた時間 (エポックからのミリ秒単位)。
Type	文字列	要求されたリソースの使用方法。
Url	文字列	URL。

WebRequestHeadersReceivedArgs

HTML の以下のイベントからデータを返します。

• Web 要求: HTTP ヘッダー受信時

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestHeadersReceivedArgs

プロパティ	入力	説明
ResponseHeaders	文字列	この応答で受信された HTTP 応答ヘッダー。
StatusCode	文字列	サーバーによって返される標準的な HTTP ステータス コードです。
StatusLine	文字列	応答の HTTP ステータス行。

WebResponseCacheDetailsArgs

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestHeadersReceivedArgs > WebResponseCacheDetailsArgs

プロパティ	入力	説明
FromCache	Boolean	この応答がディスク キャッシュからフェッチされたかどうかを示します。
Ip	文字列	要求が実際に送信されたサーバーの IP アドレス。

WebRequestBeforeRedirectArgs

HTML の以下のイベントからデータを返します。

• Web 要求: リダイレクト前

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebResponseCacheDetailsArgs > WebRequestBeforeRedirectArgs

プロパティ	入力	説明
RedirectUrl	文字列	リダイレクト URL。

WebRequestBeforeRequestArgs

HTML の以下のイベントからデータを返します。

• Web 要求: 要求前

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestBeforeRequestArgs

WebRequestBeforeSendHeadersArgs

HTML の以下のイベントからデータを返します。

• Web 要求: HTTP ヘッダーの送信前

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestBeforeSendHeadersArgs

プロパティ	入力	説明
RequestHeaders	文字列	この要求とともに送信される HTTP 要求ヘッダー。

WebRequestCompletedArgs

HTML の以下のイベントからデータを返します。

• Web 要求: 完了時

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestHeadersReceivedArgs > WebResponseCacheDetailsArgs > WebRequestCompletedArgs

WebRequestErrorOccurredArgs

HTML の以下のイベントからデータを返します。

• Web 要求: エラー発生時

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestErrorOccurredArgs

プロパティ	入力	説明
Error	文字列	エラーの説明。
FromCache	Boolean	この応答がディスク キャッシュからフェッチされたかどうかを示します。
Ip	文字列	要求が実際に送信されたサーバーの IP アドレス。

WebRequestResponseStartedArgs

HTML の以下のイベントからデータを返します。

• Web 要求: 応答開始時

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestHeadersReceivedArgs > WebResponseCacheDetailsArgs > WebRequestResponseStartedArgs

WebRequestSendHeadersArgs

HTML の以下のイベントからデータを返します。

• Web 要求: HTTP ヘッダー送信時

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestSendHeadersArgs

プロパティ	入力	説明
RequestHeaders	文字列	この要求とともに送信される HTTP 要求ヘッダー。

UiaToggledArgs

UIA の以下のイベントからデータを返します。

• 「切り替え」イベント

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > UiaToggledArgs

プロパティ	入力	説明
State	文字列	ターゲット要素の新しいステートです。

UiaTextSelectionChangedArgs

UIA の以下のイベントからデータを返します。

• テキスト選択の変更イベント

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > UiaTextSelectionChangedArgs

プロパティ	入力	説明
TextRanges	UiaTextRange()	ターゲット要素内の選択したテキスト要素に関するさまざまな情報を保持する配列 (隣接していないテキストが選択されている場合は、複数のテキスト要素が選択されることがあります)。 この配列の各アイテムは、次の情報を示します。 Text (String 型) - 選択したテキスト要素のテキストを選択します。例: TriggerEventArgs.TextRanges(0).Text は、最初に選択したテキスト要素のテキストを表します。 BoundingRectangles (Rectangle()) 型) - 選択したテキスト要素の境界四角形の配列です。選択したテキスト要素は、複数の行にまたがる場合、複数の境界四角形が関連付けられることがあります。 それぞれの境界四角形は Rectangle 型 {X、Y、Width、Height} で、要素の位置とサイズに関する情報を提供します。 例： TriggerEventArgs.TextRanges(0).BoundingRectangles(0) は、最初に選択したテキスト要素の最初の行の境界四角形を表します。

イベント検査ツール

トリガーベースの有人オートメーションのコンテキストでは、イベント検査ツールを使用して、アプリケーション内の特定の UI 要素を操作したときにトリガーされるネイティブ イベントの種類を識別し、[アプリケーション イベント トリガー] アクティビティを設定することができます。このツールは、クリック、キーの押下、フォーカスの取得、フォーカスの喪失、その他の関連する操作など、選択したすべての種類のイベントをキャプチャして監視します。それにより、実行されたアクションを分析し、発生した問題を診断することができます。

有効な UI 要素が選択されている状態で [イベントを検査] ツールバー ボタンをクリックすると、UI Explorer からイベント検査ツールを開くことができます。

ツールバーは、次のオプションで構成されています。

• 記録 - UI 要素を操作することによって生成されたイベントが記録され、イベント リストに追加されます。
• 一時停止 - UI 要素を操作したときにその UI 要素によって生成されるイベントが記録されなくなります。
• 強調表示 - ターゲット要素の輪郭を表示し、数秒間前面に移動します。強調表示は無効化されるまでオンのままになります。
• UI Explorer で開く - 監視対象の要素が UI Explorer で開き、その要素のセレクターを確認できます。

イベントの記録を開始すると、さらに 2 つのオプションが利用可能になります。

• クリア - 記録されたすべてのイベントを削除します。
• CSV - キャプチャしたイベントを .csv ファイルにエクスポートして、さらに詳しく分析することができます。

[イベント検査ツール] ウィンドウには、以下の 2 つのメイン セクションがあります。

• イベント フィルター - ターゲット要素に対して監視するイベントの種類を選択できます。
• イベント リスト - キャプチャしたイベントに関する情報を表示します。

特定の種類のイベントをフィルタリングしてキャプチャするには、イベントの種類のリストでチェックボックスをオンまたはオフにします。リストは、選択した要素のテクノロジによって異なる場合があります。

Web または Java UI 要素に固有のあらゆる種類のマウス イベント (マウスの移動、マウスの押下、マウスの解放、マウスの到達、マウスの離れ) は、イベント リストが増大する可能性があるため、既定では無効になっています。そうした種類のマウス イベントを有効化するのは、特に監視が必要な場合だけにすることをお勧めします。

また、イベントの記録の開始後にも、そうした種類のイベントを有効化または無効化できます。

イベント リストには、以下の 3 つの列があります。

• イベント名 - イベントの種類です。
• タイム スタンプ - イベントが実行された日付と時間です。
• イベント データ - 特定のイベントに関するデータとパラメーターです。

各列は、昇順または降順に並べ替えることができます。既定では、イベントは実行された順に表示されます。

[消滅] というイベントの種類が検出されると、監視を続行できなくなり、画面にエラー メッセージが表示されます。ツールバーのオプションをクリックすると、同じエラー メッセージが画面に表示されます。利用可能なオプションは、データのクリアか、.csv ファイルへのエクスポートのみです。監視を再開するには、ウィンドウを閉じて、イベント検査ツールの別のインスタンスを開きます。