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

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	ターゲット要素が消滅したときにトリガーされます。
テキストの変更	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 以降、ネイティブの埋め込みブラウザー (Slack、Discord、Electron など) で WEBCTRL ベースのネイティブ イベントがサポートされるようになりました。

UiPath.UIAutomation.Activities v23.12 以降、埋め込みのマネージド ブラウザー (CefSharp など) で WEBCTRL ベースのネイティブ イベントがサポートされるようになりました。

Text selection changed イベントは、UiPath.UIAutomation.Activities v23.12 以降の埋め込みブラウザーでサポートされています。

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

HTML イベント - UI 要素

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

• Download state changed

• Tab activated

• Tab created

• Tab removed

• Tab updated

現在のところ、これらのイベントは、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	ウィンドウが削除された (閉じられた) ときにトリガーされます。

UIA イベント - UI 要素

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

TriggerEventArgs プロパティ

トリガーの引数

トリガーに関連するすべての args クラスの基底クラスです。

プロパティ	入力	説明
TriggerName	文字列	トリガーの名前です (アクティビティ名として表示されます)。
TriggerType	入力	TriggerEventArgs の型です。

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	文字列	ウィンドウ ハンドル (文字列) です。

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	日付	N/A

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	日付	N/A

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 です。

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 ファイルへのエクスポートのみです。監視を再開するには、ウィンドウを閉じて、イベント検査ツールの別のインスタンスを開きます。