RoutedEventArgs クラス

  • リファレンス

定義

名前空間:
Microsoft.UI.Xaml
編集

ルーティング イベントに関連付けられている状態情報とイベント データを格納します。

/// [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
継承
Object IInspectable RoutedEventArgs
派生
属性
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

注釈

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 派生したイベント データがない場合があります。

コンストラクター

RoutedEventArgs()

RoutedEventArgs クラスの新しいインスタンスを初期化します。

プロパティ

OriginalSource

イベントを発生させたオブジェクトへの参照を取得します。 これは多くの場合、アプリ UI で宣言された要素ではなく、コントロールのテンプレート部分です。

適用対象

こちらもご覧ください