activities
latest
false
重要 :
このコンテンツの一部は機械翻訳によって処理されており、完全な翻訳を保証するものではありません。
UI Automation のアクティビティ
Last updated 2024年8月13日

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

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 値 (TrueFalse) のみがサポートされています。既定値は False です。

オプション

  • 子を含む - 選択すると、指定した UI 要素の子も監視されます。[出現] または [消滅] を除くすべてのイベントの種類と、トップレベル ウィンドウを除くすべての UI 要素をサポートしています。このフィールドでは、Boolean 値 (TrueFalse) のみがサポートされています。既定値は 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' />)。その他の属性 (titleurl など) は使用できません。ウィンドウ セレクターに app 以外の属性が含まれている場合は、実行時エラーが生成されます。

[厳密セレクター] は空である必要があります。

これらの種類のイベントは、埋め込みブラウザーではサポートされていません。

イベントの種類TriggerEventArgs の種類説明
ダウンロードのステートの変更 DownloadChangedArgsDownloadItem のいずれかのプロパティが変更されたときにトリガーされます。
タブのアクティブ化 TabActivatedArgs

ウィンドウのアクティブなタブが変更されたときにトリガーされます。

注: このイベントが発生した時点ではタブの URL が設定されていない場合がありますが、onUpdated イベントをリッスンして、URL が設定されたときに通知を受け取ることができます。
タブの作成 TabCreatedArgs

タブが作成されたときにトリガーされます。

注: このイベントが発生した時点では、タブの URL やタブ グループ メンバーシップが設定されていない可能性がありますが、onUpdated イベントをリッスンして、URL が設定されたりタブがタブ グループに追加されたりしたときに通知を受け取ることができます。
タブの削除 TabRemovedArgsタブが閉じられたときにトリガーされます。
タブの更新TabUpdatedArgsタブが更新されたときにトリガーされます。
タブ ナビゲーションの開始TabNavigationStartedArgs特定の URL へのタブ ナビゲーションが開始されたときにトリガーされるイベントです。
タブ ナビゲーションの終了TabNavigationCompletedArgs特定の URL へのタブ ナビゲーションが完了したときにトリガーされます。
ウィンドウのフォーカスの変更HtmlWindowFocusChangedArgs現在フォーカスされているウィンドウが変更されたときにトリガーされます。
ウィンドウの境界の変更HtmlWindowBoundsChangedArgsウィンドウのサイズが変更されたときにトリガーされます。これは、新しい境界が確定されたときにのみディスパッチされ、進行中の変更にはディスパッチされません。
ウィンドウの作成HtmlWindowCreatedArgsウィンドウが作成されたときにトリガーされます。
ウィンドウの削除HtmlWindowRemovedArgsウィンドウが削除された (閉じられた) ときにトリガーされます。

UIA イベント - UI 要素

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

TriggerEventArgs プロパティ

トリガーの引数

トリガーに関連するすべての args クラスの基底クラスです。
プロパティ入力説明
TriggerName文字列このイベントを生成したトリガー アクティビティの名前です (アクティビティ名として表示されます)。
TriggerType入力このイベントを生成したトリガー アクティビティの .NET 型です。

UiElementTriggerArgs

継承: TriggerArgs > UiElementTriggerArgs
プロパティ入力説明
Selector文字列ターゲット要素のセレクターです。
TargetElementUI 要素監視対象のターゲット要素です。

NativeTriggerBaseArgs

継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs
プロパティ入力説明
SelectorIndexIntegerターゲット要素セレクターのインデックスです。

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
プロパティ入力説明
HwndIntptrウィンドウ ハンドルです。
HwndAsString文字列ウィンドウ ハンドル (文字列) です。

KeyPressArgs

WND 要素と CTRL 要素の以下のイベントからデータを返します。
  • キーの押下
継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > KeyPressArgs
プロパティ入力説明
KeyInteger操作されたキーです。
ScanCodeInteger操作されたキーに対応するスキャン コードです。
KeyActionIntegerキーが押されたか、それとも解放されたかを示します。予想される値:
  • 0 - キーが押された
  • 1 - キーが解放された
KeyModifiersNKeyModifiersキーと共に使用されたキー修飾子。予想される値:
  • None = 0
  • Alt = 1
  • Ctrl = 2
  • Shift = 4
  • Win = 8

MouseClickedArgs

WND 要素と CTRL 要素の以下のイベントからデータを返します。
  • クリック
継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > MouseClickedArgs
プロパティ入力説明
XIntegerマウス ポインターの X 座標です。
YIntegerマウス ポインターの Y 座標です。
MouseButtonIntegerクリックされたマウス ボタン。予想される値:
  • 0 - なし
  • 1 - 左
  • 2 - 中央
  • 3 - 右
MouseActionIntegerマウス ボタンが押されたか、それとも解放されたかを示します。予想される値:
  • 0 - マウス ボタンが押された
  • 1 - マウス ボタンが解放された
KeyModifiersNKeyModifiersマウス ボタンと共に使用されたキー修飾子。予想される値:
  • None = 0
  • Alt = 1
  • Ctrl = 2
  • Shift = 4
  • Win = 8

JavaKeyPressArgs

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

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

JavaMouseActionArgs

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

  • クリック
  • マウス ボタンの押下
  • マウス ボタンの解放
継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaMouseActionArgs
プロパティ入力説明
XIntegerマウス ポインターの X 座標です。
YIntegerマウス ポインターの Y 座標です。
ButtonIntegerクリックされたマウス ボタン。予想される値:
  • 1 - 左
  • 2 - 中央
  • 3 - 右
ClickCountIntegerボタンがクリックされた回数です。
KeyModifiersNKeyModifiersマウス ボタンと共に使用されたキー修飾子。予想される値:
  • None = 0
  • Alt = 1
  • Ctrl = 2
  • Shift = 4
  • Win = 8

JavaMouseMotionArgs

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

  • マウスの移動
  • マウスの到達
  • マウスの離れ
継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaMouseMotionArgs
プロパティ入力説明
XIntegerマウス ポインターの X 座標です。
YIntegerマウス ポインターの Y 座標です。
MouseButtonIntegerクリックされたマウス ボタン。予想される値:
  • 0 - なし
  • 1 - 左
  • 2 - 中央
  • 3 - 右

JavaCellSelectedArgs

Java の以下のイベントからデータを返します。
  • クリック
継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaCellSelectedArgs
プロパティ入力説明
RowInteger選択されたセルの行です。
ColumnInteger選択されたセルの列です。

JavaCellValueChangedArgs

Java の以下のイベントからデータを返します。
  • クリック
継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaCellValueChangedArgs
プロパティ入力説明
RowIntegerセルの行です。
ColumnIntegerセルの列です。
Value文字列セルの新しい値です。

WebMouseEventArgs

WEBCTRL の以下のイベントからデータを返します。
  • クリック
  • ダブル クリック
  • 右クリック
  • マウスの移動
  • マウスの到達
  • マウスの離れ
  • マウス ボタンの押下
  • マウス ボタンの解放
継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebMouseEventArgs
注: マウス イベントに対して定義されたプロパティ名に従います。
プロパティ入力説明
AltKeyBooleanAlt キーが押されたかどうかです。
ButtonIntegerどのマウス ボタンが押されたか。予想される値:
  • 0 - 左
  • 1 - 中央
  • 2 - 右
ClientXIntegerマウス ポインターの X 座標 (ウィンドウを基準にした相対座標) です。
ClientYIntegerマウス ポインターの Y 座標 (ウィンドウを基準にした相対座標) です。
CtrlKeyBooleanCtrl キーが押されたかどうかです。
MetaKeyBooleanメタ キーが押されたかどうかです。
MovementXIntegerマウス ポインターの X 座標 (最後の mousemove イベントの位置を基準にした相対座標) です。
MovementYIntegerマウス ポインターの Y 座標 (最後の mousemove イベントの位置を基準にした相対座標) です。
OffsetXIntegerマウス ポインターの X 座標 (ターゲットを基準にした相対座標) です。
OffsetYIntegerマウス ポインターの Y 座標 (ターゲットを基準にした相対座標) です。
PageXIntegerマウス ポインターの X 座標 (ドキュメントを基準にした相対座標) です。
PageYIntegerマウス ポインターの Y 座標 (ドキュメントを基準にした相対座標) です。
ScreenXIntegerマウス ポインターの X 座標 (画面を基準にした相対座標) です。
ScreenYIntegerマウス ポインターの Y 座標 (画面を基準にした相対座標) です。
ShiftKeyBooleanShift キーが押されたかどうかです。

WebKeyPressArgs

WEBCTRL の以下のイベントからデータを返します。
  • キーの押下
継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebKeyPressArgs
注: キーボード イベントに対して定義されたプロパティ名に従います。
プロパティ入力説明
AltKeyBooleanAlt キーが押されたかどうかです。
Code文字列イベントをトリガーしたキーのコードです (例: KeyAKeyBControlLeftControlRight)。
CtrlKeyBooleanCtrl キーが押されたかどうかです。
IsComposingBooleanイベントのステートが変換中かどうかです。
Key文字列イベントをトリガーしたキーの値です (例: abControl)
LocationIntegerキーボードまたはデバイス上のキーの場所。予想される値:
  • 0 - 標準 - キーボードのほぼすべてのキーを表す
  • 1 - 左キーが押された
  • 2 - 右キーが押された
  • 3 - テンキーのキーが押された
MetaKeyBooleanメタ キーが押されたかどうかです。
RepeatBooleanキーが繰り返し押されたままになっているかどうかです。
ShiftKeyBooleanShift キーが押されたかどうかです。

WebTextSelectionChangedArgs

WEBCTRL の以下のイベントからデータを返します。
  • テキスト選択の変更
継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebTextSelectionChangedArgs
注: キーボード イベントに対して定義されたプロパティ名に従います。
プロパティ入力説明
AnchorClientBounds矩形領域アンカー クライアントの境界: 要素のサイズおよびビューポートを基準とした位置に関する情報。
AnchorElementUI 要素アンカーの UI 要素です。
AnchorOffsetInteger(ターゲット要素のフル テキストから) テキストの選択が開始された文字の 0 ベースのインデックスです。
FocusClientBounds矩形領域フォーカス クライアントの境界とは、要素のサイズとビューポートを基準とした位置に関する情報です。
FocusElementUI 要素フォーカスがある UI 要素です。
FocusOffsetInteger(ターゲット要素のフル テキストから) テキストの選択が終了された文字の、0 ベースのインデックスです。
SelectedText文字列ターゲット要素の新しいテキストの選択です。

DownloadChangedArgs

WEBCTRL の以下のイベントからデータを返します。
  • ダウンロードのステートの変更
継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > DownloadChangedArgs
プロパティ入力説明
State文字列downloads.DownloadItemstate の変更を説明する文字列です。
Id文字列変更された downloads.DownloadItemid です。
FileName文字列downloads.DownloadItemurl の変更を説明する文字列です。
Url文字列downloads.DownloadItemfilename の変更を説明する文字列です。
StartTime文字列downloads.DownloadItemstartTime の変更を説明する文字列です。
EndTime文字列downloads.DownloadItemendTime の変更を説明する文字列です。
Error文字列downloads.DownloadItemerror ステータスの変更を説明する文字列です。

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 です。
IsWindowClosingBooleanTrue 親ウィンドウが閉じられたためタブが閉じられた場合

TabUpdatedArgs

WEBCTRL の以下のイベントからデータを返します。
  • タブの更新
継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabUpdatedArgs
プロパティ入力説明
TabId文字列更新されたタブの ID です。
WindowId文字列タブを含むウィンドウの ID です。
Status文字列タブの読み込みステータスです。
Title文字列タブの新しいタイトルです。
Url文字列タブの URL (変更された場合)
ActiveBooleanタブがウィンドウでアクティブかどうかを示します。必ずしもこのウィンドウにフォーカスがあるわけではありません。

TabNavigationStartedArgs

HTML の以下のイベントからデータを返します。
  • タブ ナビゲーションの開始
継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabNavigationStartedArgs
プロパティ入力説明
Url文字列フレームに現在関連付けられている URL (FrameId によって識別されるフレームが、指定されたタブ内のあるポイントに存在していた場合)。URL が特定の FrameId に関連付けられていても、対応するフレームが依然として存在するとは限りません。
TabIdIntegerフレームが存在するタブの ID。
FrameIdInteger

開始イベントが実行され、タブ ナビゲーションが発生したタブ内のフレームの ID。

フレームは、TabIdFrameId によって一意に識別されます。
TimeStampMsDouble

タブ ナビゲーションが開始された時刻 (エポックからのミリ秒単位)。

Web ナビゲーションのイベントの TimeStampMs プロパティは、内部的に一貫性があることのみが保証されます。あるイベントを別のイベントと比較すると、イベント間の正しいオフセットが得られますが、拡張機能内の現在の時刻 ((new Date()).getTime() など) と比較すると、予期しない結果が生じる可能性があります。
DateTime日付タブ ナビゲーションが開始された日時 (UTC)。

TabNavigationCompletedArgs

HTML の以下のイベントからデータを返します。
  • タブ ナビゲーションの終了
継承: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabNavigationCompletedArgs
プロパティ入力説明
Url文字列フレームに現在関連付けられている URL です (FrameId によって識別されるフレームが、指定されたタブ内にある時点で存在していた場合)。URL が特定の FrameId に関連付けられていても、対応するフレームが依然として存在するとは限りません。
TabIdIntegerフレームが存在するタブの ID です。
FrameIdInteger

完了したイベントが発生し、タブ ナビゲーションが発生したタブ内のフレームの ID です。

フレームは、TabIdFrameId によって一意に識別されます。
TimeStampMsDouble

タブ ナビゲーションが完了した時刻 (エポックからのミリ秒単位)。

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。
FocusedBooleanウィンドウが現在フォーカスされているウィンドウかどうか。
TopInteger画面の上端からのウィンドウのオフセット (ピクセル単位)。
LeftInteger画面の左端からのウィンドウのオフセット (ピクセル単位) です。
WidthIntegerフレームを含むウィンドウの幅 (ピクセル単位)。
HeightIntegerフレームを含むウィンドウの高さです (ピクセル単位)。

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
プロパティ入力説明
TextRangesUiaTextRange()

ターゲット要素内の選択したテキスト要素に関するさまざまな情報を保持する配列 (隣接していないテキストが選択されている場合は、複数のテキスト要素が選択されることがあります)。

この配列の各アイテムは、次の情報を示します。

  • Text (String 型) - 選択したテキスト要素のテキストを選択します。例: TriggerEventArgs.TextRanges(0).Text は、最初に選択したテキスト要素のテキストを表します。
  • BoundingRectangles (Rectangle()) 型) - 選択したテキスト要素の境界四角形の配列です。選択したテキスト要素は、複数の行にまたがる場合、複数の境界四角形が関連付けられることがあります。
    それぞれの境界四角形は Rectangle 型 {XYWidthHeight} で、要素の位置とサイズに関する情報を提供します。

    例:

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


このページは役に立ちましたか?

サポートを受ける
RPA について学ぶ - オートメーション コース
UiPath コミュニティ フォーラム
Uipath Logo White
信頼とセキュリティ
© 2005-2024 UiPath. All rights reserved.