Compartilhar via

RoutedEventArgs Classe

  • Referência

Definição

Namespace:
Microsoft.UI.Xaml
Editar

Contém informações de estado e dados de eventos 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 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 delegada é 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 o WPF declara uma propriedade chamada 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 no WPF (isso influencia a rota de eventos 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 no WPF). Por exemplo, você pode definir Handled se estiver manipulando um evento de ponteiro e a classe de dados de evento for PointerRoutedEventArgs, mas você não poderá definir Handled para um evento Loaded em que os dados de evento sejam uma instância RoutedEventArgs.

Classes derivadas de RoutedEventArgs

RoutedEventArgsé a classe pai de várias classes imediatamente derivadas 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

RoutedEventArgs()

Inicializa uma nova instância da classe RoutedEventArgs .

Propriedades

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