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 ,由于事件数据类型指示具有此事件数据的事件是 路由事件,但存在一些例外情况。 有关路由事件及其处理方法的详细信息,请参阅 事件和路由事件概述。
添加到通用事件数据集的 API RoutedEventArgs 为 OriginalSource。
OriginalSource 对于确定首次引发事件进行命中测试和事件路由方案的元素非常有用,但有时来自委托签名的 发送方 是处理程序更有用的源对象引用。 有关详细信息,请参阅 事件和路由事件概述。
RoutedEventArgs 和 Handled 属性
如果你熟悉Windows Presentation Foundation(WPF),你可能知道WPF声明了一RoutedEventArgs个在类上命名Handled的属性。 Windows 运行时中的某些路由事件数据类还定义了一个Handled属性,并且使用的方式与WPF相同(它会影响处理程序中的事件路由)。但是,对于Windows 应用 SDK,此行为仅特定于某些路由事件,而不是所有路由事件(如WPF中所示)。 例如,如果要处理指针事件并且事件数据类为 PointerRoutedEventArgs,则可以设置 Handled,但不能为事件数据为 RoutedEventArgs 实例的已加载事件设置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 中声明的元素。 |