RoutedEventArgs クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ルーティング イベントに関連付けられている状態情報とイベント データを格納します。
/// [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
- 継承
- 派生
- 属性
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 から派生したイベント データがない場合があります。
- 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
- RateChangedRoutedEventArgs
- TimelineMarkerRoutedEventArgs
コンストラクター
RoutedEventArgs() |
RoutedEventArgs クラスの新しいインスタンスを初期化します。 |
プロパティ
OriginalSource |
イベントを発生させたオブジェクトへの参照を取得します。 これは多くの場合、アプリ UI で宣言された要素ではなく、コントロールのテンプレート部分です。 |