RoutedEventArgs クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ルーティング イベントに関連付けられている状態情報とイベント データを格納します。
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class RoutedEventArgs
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class RoutedEventArgs
Public Class RoutedEventArgs
- 継承
- 派生
- 属性
注釈
RoutedEventArgs
は、C++ または C# を使用するWindows アプリ SDK アプリの基本要素イベントに使用される一般的なイベント データ型です。 一般 RoutedEventArgs
に、イベント データ型は、このイベント データを含むイベントが ルーティング イベントであることを示しますが、いくつかの例外があります。 ルーティング イベントとその処理方法の詳細については、「 イベントとルーティング イベントの概要」を参照してください。
一般化されたイベント データ セットに追加される RoutedEventArgs
API は OriginalSource です。
OriginalSource
は、ヒット テストとイベント ルーティングのシナリオで最初にイベントを発生させた要素を決定するのに役立ちますが、デリゲートシグネチャの 送信者 がハンドラーのより便利なソース オブジェクト参照である場合もあります。 詳しくは、「イベントとルーティング イベントの概要」をご覧ください。
RoutedEventArgs と Handled プロパティ
Windows Presentation Foundation (WPF) に慣れている場合は、WPF が クラスで RoutedEventArgs
という名前Handled
のプロパティを宣言していることがわかります。 Windows ランタイムの特定のルーティング イベント データ クラスもプロパティをHandled
定義し、WPF で行ったのと同じ方法で使用します (ハンドラー内からのイベント ルートに影響します)。ただし、Windows アプリ SDKこの動作は、すべてのルーティング イベントではなく、特定のルーティング イベントにのみ固有です (WPF の場合と同様)。 たとえば、ポインター イベントを処理していて、イベント データ クラスが PointerRoutedEventArgs の場合は Handled を設定できますが、イベント データが RoutedEventArgs インスタンスである Loaded イベントには設定Handled
できません。
RoutedEventArgs 派生クラス
RoutedEventArgs
は、UI 要素を含むWindows ランタイム イベントのイベント データを定義する、いくつかの直ちに派生したクラスの親クラスです。 クラスがデータを提供するすべてのイベントが、「イベントとルーティング イベントの概要」で定義されている ルーティング イベントであるとは限りません。 しかし、多くはです。 互換性上の理由から、 から RoutedEventArgs
派生したイベント データがない場合があります。
- DragEventArgs
- ExceptionRoutedEventArgs
- SizeChangedEventArgs
- CleanUpVirtualizedItemEventArgs
- ContextMenuEventArgs
- ItemClickEventArgs
- SelectionChangedEventArgs
- TextChangedEventArgs
- DragCompletedEventArgs
- DragDeltaEventArgs
- DragStartedEventArgs
- RangeBaseValueChangedEventArgs
- ScrollEventArgs
- HyperlinkClickEventArgs
- DoubleTappedRoutedEventArgs
- HoldingRoutedEventArgs
- KeyRoutedEventArgs
- ManipulationCompletedRoutedEventArgs
- ManipulationDeltaRoutedEventArgs
- ManipulationInertiaStartingRoutedEventArgs
- ManipulationStartedRoutedEventArgs
- ManipulationStartingRoutedEventArgs
- PointerRoutedEventArgs
- RightTappedRoutedEventArgs
- TappedRoutedEventArgs
コンストラクター
RoutedEventArgs() |
RoutedEventArgs クラスの新しいインスタンスを初期化します。 |
プロパティ
OriginalSource |
イベントを発生させたオブジェクトへの参照を取得します。 これは多くの場合、アプリ UI で宣言された要素ではなく、コントロールのテンプレート部分です。 |