UI Automation のアクティビティ

最終更新日時 2025年11月18日

キー押下イベントトリガー

UiPath.UIAutomationNext.Activities.NKeyboardTrigger

説明

指定した UI 要素に対するキー押下のイベントトリガーを設定します。

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

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

注:

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

プロジェクトの対応 OS

Windows - レガシ | Windows

Windows - レガシ、Windows での設定

[画面上でターゲットを指定] をクリックして、ターゲットとして使用する UI 要素を指定します。

ターゲットを指定したら、メニュー ボタンをクリックします。以下のオプションが表示されます。
- 画面上でターゲットを指定 - ターゲットをもう一度指定します。
- ターゲットを編集 - 選択モードを開いて、ターゲットを設定します。
- 参考スクリーンショットを削除 - 対象のアプリケーションまたは Web ページのスクリーンショットを削除します。
- オブジェクトリポジトリに追加 - 現在の UI 要素をライブラリプロジェクトに追加し、オートメーションプロセス全体で要素を再利用することができます。
キー修飾子 - 監視するキーシーケンスにキー修飾子 ([None (なし)]、[Win]、[Ctrl]、[Alt]、[Shift]) を追加します。
Special Keys - Setup a key-pressed event trigger on the indicated UI element.
イベントをブロック - 指定した要素上でイベントが実行されないようにブロックするかどうかを指定します。False にすると、要素に対してイベントが実行されます。True にすると、イベントがブロックされます。このイベントは、[ユーザーイベントを再生] アクティビティの [イベント情報] プロパティを TriggerEventArgs.Event に設定して、後でアクティビティハンドラー内で再生することができます。このフィールドでは Boolean 値のみがサポートされています。既定値は False です。
子要素を含む - いずれかの子要素がアクションの対象になっている場合にイベントをトリガーします。選択すると、指定した UI 要素の子も監視されます。このフィールドでは Boolean 値のみがサポートされています。既定値は [True] です。

プロパティパネル

入力

キー - 監視するキーです。特殊キーがサポートされており、ドロップダウンメニューから選択できます。キーを設定する必要があります。

オプション

有効 - [False] に設定すると、トリガーは起動しますがイベントは開始されません。後で [ローカルトリガーを有効化] アクティビティを使用して実行時に有効化できます。このフィールドでは Boolean 値のみがサポートされています。既定値は [True] です。

スケジュールモード - トリガーが発生した場合のアクションの実行方法を指定します。ドロップダウンメニューから次の 5 つのオプションのいずれかを選択します。
- Sequential - アクションは 1 つずつ順番に実行されます。
- Concurrent - アクションの実行が重なる場合があります。
- OneTime - 1 つのアクションを実行し、監視を終了します。
- SequentialCollapse - 現在のイベントの実行が完了するまで、今後発生するすべてのイベント (最新のイベントを除く) を無視します。
- 順次 (drop) - 前のイベントの実行を停止し、次のイベントを開始します。
[順次] と [同時] モードでは、ユーザーが実行を停止するか [繰り返しを終了] アクティビティに到達するまで監視が継続します。

トリガーモード - キーが押されたか解放されたときにイベントがトリガーされるかどうかを指定します。Down または Up の 2 つのオプションのどちらかを選択します。既定値は Down です。
Healing Agent モード - プロセスレベルまたはジョブレベルでのガバナンスまたは Orchestrator の設定に基づいて、このアクティビティでの Healing Agent の動作を設定します。
- 無効化 - このアクティビティの Healing Agent をオフにします。
- ジョブの設定を継承 - ガバナンスまたは Orchestrator で定義された設定を、プロセスレベルまたはジョブレベルで適用します。
- 推奨事項のみ - Healing Agent が、実行中のジョブの UI Automation の問題を修正するための推奨事項を提供できるようにします。ただし、ガバナンスまたは Orchestrator の設定で許可されている場合に限ります。
- アプリ/ブラウザーと同一 - 親の [アプリケーション/ブラウザーを使用] アクティビティの設定を継承します。