RoutedEventArgs クラス

  • リファレンス

定義

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

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

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 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(Windows.Foundation.UniversalApiContract), 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

Windows の要件

デバイス ファミリ
Windows 10 (10.0.10240.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v1.0 で導入)

注釈

RoutedEventArgs は、C++、C#、または Visual Basic を使用する UWP アプリの基本要素イベントに使用される一般的なイベント データ型です。 一般に、イベント データ型としての RoutedEventArgs は、このイベント データを含むイベントが ルーティング イベントであることを示しますが、例外がいくつかあります。 ルーティング イベントとその処理方法の詳細については、「 イベントとルーティング イベントの概要」を参照してください。

一般化されたイベント データ セットに RoutedEventArgs が追加する API は OriginalSource です。 OriginalSource は、ヒット テストおよびイベント ルーティング シナリオで最初にイベントを発生させた要素を決定するのに役立ちますが、デリゲートシグネチャの 送信者 がハンドラーのより有用なソース オブジェクト参照である場合もあります。 詳しくは、「イベントとルーティング イベントの概要」をご覧ください。

RoutedEventArgs と Handled プロパティ

Windows Presentation Foundation (WPF) に精通している場合は、Windows Presentation Foundation (WPF) が RoutedEventArgs クラスで Handled という名前のプロパティを宣言していることがわかります。 Windows ランタイムの特定のルーティング イベント データ クラスでも Handled プロパティを定義し、Windows Presentation Foundation (WPF) と同じように使用します (ハンドラー内からのイベント ルートに影響します)。ただし、Windows ランタイムおよび Microsoft Silverlight の場合、この動作は、すべてのルーティング イベントではなく、特定のルーティング イベントにのみ固有です (Windows Presentation Foundation (WPF) の場合と同様)。 たとえば、ポインター イベントを処理していて、イベント データ クラスが PointerRoutedEventArgs の場合に Handled を設定できますが、イベント データが RoutedEventArgs インスタンスである Loaded イベントに対して Handled を設定することはできません。

RoutedEventArgs 派生クラス

RoutedEventArgs は、UI 要素を含むWindows ランタイムイベントのイベント データを定義する、直ちに派生した複数のクラスの親クラスです。 クラスがデータを提供するすべてのイベントが、「 イベントとルーティング イベントの概要」で定義されているルーティング イベントであるとは限りません。 しかし、多くはです。 互換性上の理由から RoutedEventArgs から派生したイベント データがない場合があります。

コンストラクター

RoutedEventArgs()

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

プロパティ

OriginalSource

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

適用対象

こちらもご覧ください