語言

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是 Windows 應用程式 SDK 中使用 C++ 或 C# 的常用事件資料型態，用於基礎元素事件。 通常 RoutedEventArgs ，事件資料類型表示包含此事件資料的事件是 路由事件，雖然也有一些例外。 關於路由事件的更多資訊及處理方法，請參閱 事件與路由事件總覽。

加入 RoutedEventArgs 一般事件資料集的 API 是 OriginalSource。 OriginalSource 對於判斷最先提出事件的元素以進行命中測試和事件路由情境非常有用，但有時代理簽章的 發送端 反而是處理程序更有用的來源物件參考。 如需詳細資訊，請參閱事件與路由事件概觀。

RoutedEventArgs 與 Handled 屬性

如果你熟悉 Windows Presentation Foundation（WPF），你可能知道 WPF 宣告了類別上RoutedEventArgs一個屬性Handled。 Windows 執行階段 中某些路由事件資料類別也會定義屬性Handled，使用方式與在 WPF 中相同（它會從處理器內部影響事件路由）。然而，對於 Windows 應用程式 SDK，這種行為只針對特定路由事件，而非所有路由事件（如 WPF 中所見）。 例如，如果你處理指標事件且事件資料類別是 PointerRoutedEventArgs，你可以設定 Handled，但無法設定 HandledLoaded 事件，事件資料是 RoutedEventArgs 實例。

RoutedEventArgs 衍生類別

RoutedEventArgs是數個立即派生的類別的父類別，這些類別定義了涉及 UI 元素的 Windows 執行階段 事件事件資料。 並非所有類別提供資料的事件都必然是如 事件與路由事件概述所定義的路由事件。 但很多人確實如此。 那些沒有的，有時會因為相容性考量而取得事件資料 RoutedEventArgs 。

建構函式

名稱 Description
RoutedEventArgs()

初始化 RoutedEventArgs 類別的新實例。

屬性

名稱 Description
OriginalSource

會得到一個指向引發事件的物件的參考。 這通常是控制項中的範本部分，而非你應用程式介面中聲明的元素。

適用於

另請參閱