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 ，事件数据类型指示具有此事件数据的事件是 路由事件，但也有一些例外情况。 有关路由事件及其处理方法的详细信息，请参阅 事件和路由事件概述。

添加到通用事件数据集的 API RoutedEventArgs 是 OriginalSource。 OriginalSource 对于确定第一次引发事件的元素（针对命中测试和事件路由方案）非常有用，但有时委托签名中的 发送方 是处理程序更有用的源对象引用。 有关详细信息，请参阅事件和路由事件概述。

RoutedEventArgs 和 Handled 属性

如果熟悉 WPF) Windows Presentation Foundation (，则可能知道 WPF 在 类上RoutedEventArgs声明了名为 Handled 的属性。 Windows 运行时中的某些路由事件数据类还定义了一个Handled属性，并且使用方式与 WPF 中的相同方式， (它从 handler 内部影响事件路由。) 但是，Windows 应用 SDK此行为仅特定于某些路由事件，而不是所有路由事件 (，在 WPF) 中也是如此。 例如，如果要处理指针事件且事件数据类为 PointerRoutedEventArgs，则可以设置 Handled，但不能为事件数据为 RoutedEventArgs 实例的 Loaded 事件设置Handled。

RoutedEventArgs 派生类

RoutedEventArgs是多个直接派生类的父类，这些类为涉及 UI 元素的Windows 运行时事件定义事件数据。 并非所有类提供数据的事件都一定是事件 和路由事件概述中定义的路由事件。 但许多是。 出于兼容性原因，有时不具有派生自 RoutedEventArgs 的事件数据。

构造函数

RoutedEventArgs()

初始化 RoutedEventArgs 类的新实例。

属性

OriginalSource

获取对引发事件的 对象的引用。 这通常是控件的模板部分，而不是在应用 UI 中声明的元素。

适用于

另请参阅