RoutedEventArgs Classe

  • Referência

Definição

Namespace:
Windows.UI.Xaml
Editar

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

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 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(Windows.Foundation.UniversalApiContract), 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

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

RoutedEventArgs é um tipo de dados de evento comum usado para eventos de elemento base no aplicativo UWP usando C++, C#ou Visual Basic. 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 Windows Presentation Foundation (WPF) declara uma propriedade chamada Handled na classe RoutedEventArgs. Determinadas classes de dados de evento roteada no Windows Runtime também definem uma propriedade Handled e você a usa da mesma maneira que fez em Windows Presentation Foundation (WPF) (isso influencia a rota de evento de dentro de seu manipulador.) No entanto, para Windows Runtime e também para o Microsoft Silverlight, esse comportamento é específico apenas para determinados eventos roteado em vez de todos os eventos roteado (como é verdade em Windows Presentation Foundation (WPF)). Por exemplo, você poderá 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 de 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 evento derivados de RoutedEventArgs 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