RoutedEventArgs Classe

Definição

Namespace:
Microsoft.UI.Xaml
Editar

Contém informações de estado e dados de evento associados a um evento roteado.

/// [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
Herança
Object IInspectable RoutedEventArgs
Derivado
Atributos
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Comentários

RoutedEventArgsé um tipo de dados de evento comum usado para eventos de elemento base em aplicativos SDK do Aplicativo Windows usando C++ ou C#. Geralmente RoutedEventArgs , como o tipo de dados de evento indica que o evento com esses dados de evento é um evento roteado, embora haja algumas exceções. Para obter mais informações sobre eventos roteado e como lidar com eles, consulte a visão geral de eventos e eventos roteado.

A API que RoutedEventArgs adiciona a um conjunto de dados de eventos generalizado é OriginalSource. OriginalSource pode ser útil para determinar o elemento que primeiro gerou o evento para cenários de teste de ocorrência e roteamento de eventos, mas também há ocasiões em que o remetente da assinatura de delegado é a referência de objeto de origem mais útil para um manipulador. Para saber mais, confira Visão geral de eventos e eventos roteados.

RoutedEventArgs e a propriedade Handled

Se você estiver familiarizado com Windows Presentation Foundation (WPF), talvez saiba que WPF declara uma propriedade nomeada Handled na RoutedEventArgs classe. Determinadas classes de dados de evento roteada no Windows Runtime também definem uma Handled propriedade e você a usa da mesma maneira que fez em WPF (isso influencia a rota de evento de dentro do manipulador).) No entanto, para SDK do Aplicativo Windows esse comportamento é específico apenas para determinados eventos roteado em vez de todos os eventos roteado (como é verdade em WPF). Por exemplo, você pode definir Handled se estiver manipulando um evento de ponteiro e a classe de dados de evento for PointerRoutedEventArgs, mas não puder definir Handled para um evento Loaded em que os dados do evento sejam uma instância routedEventArgs.

Classes derivadas de RoutedEventArgs

RoutedEventArgsé a classe pai de várias classes derivadas imediatamente que definem dados de evento para eventos Windows Runtime envolvendo elementos da interface do usuário. Nem todos os eventos em que as classes fornecem dados são necessariamente eventos roteado conforme definido em Eventos e visão geral de eventos roteado. Mas muitos são. Os que às vezes não têm os dados de RoutedEventArgs evento derivados por motivos de compatibilidade.

Construtores

Nome Description
RoutedEventArgs()

Inicializa uma nova instância da classe RoutedEventArgs .

Propriedades

Nome Description
OriginalSource

Obtém uma referência ao objeto que gerou o evento. Isso geralmente é uma parte de modelo de um controle em vez de um elemento que foi declarado na interface do usuário do aplicativo.

Aplica-se a

Confira também