KeyRoutedEventArgs Classe

Definição

Namespace:

Windows.UI.Xaml.Input

Fornece dados de evento para os eventos roteado KeyUp e KeyDown .

public ref class KeyRoutedEventArgs sealed : RoutedEventArgs

/// [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 KeyRoutedEventArgs final : 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 sealed class KeyRoutedEventArgs : RoutedEventArgs

Public NotInheritable Class KeyRoutedEventArgs
Inherits RoutedEventArgs

Herança

Object Platform::Object IInspectable RoutedEventArgs KeyRoutedEventArgs

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

A entrada do botão é mapeada para valores de chave diferentes para vários dispositivos.

Esta tabela fornece os detalhes de mapeamento para o game pad e dispositivos remotos.

Botão	50	GamepadDPadUp/Down/Left/Right	GamepadDPadUp/Down/Left/Right ou NavigationUp/Down/Left/Right
	GamepadLeftThumbstickButton/Up/Down/Left/Right ou GamepadRightThumbstickButton/Up/Down/Left/Right	GamepadLeftThumbstickButton/Up/Down/Left/Right ou GamepadRightThumbstickButton/Up/Down/Left/Right ou NavigationUp/Down/Left/Right
	GamePadRightTrigger/LeftTrigger	GamePadRightTrigger/LeftTrigger
	GamePadRightShoulder/LeftShoulder	GamePadRightShoulder/LeftShoulder
	GamepadMenu	GamepadMenu ou NavigationMenu
	GamepadView	GamepadView ou NavigationView

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1607	14393	deviceId

Propriedades

DeviceId	Obtém uma ID exclusiva para o dispositivo de entrada que gerou esse evento de chave. Use DeviceId para diferenciar entre todos os dispositivos conectados que podem gerar eventos-chave, como vários controladores de jogo. Não há suporte para DeviceId para todos os dispositivos de entrada.
Handled	Obtém ou define um valor que marca o evento roteado como manipulado. Um valor verdadeiro para Handled impede que a maioria dos manipuladores ao longo da rota de evento manipule o mesmo evento novamente.
Key	Obtém a chave virtual associada ao evento. Dependendo do dispositivo de entrada, esse pode ser um valor mapeado. Para obter dados de evento brutos e não mapeados, consulte a propriedade OriginalKey .
KeyStatus	Obtém um valor de estrutura que relata várias características detectadas pelo sistema da tecla press, incluindo contagem de repetição e status de menu.
OriginalKey	Obtém a chave virtual original e não mapeada associada ao evento. Dependendo do dispositivo de entrada, o botão de entrada pode ser mapeado para um valor de chave diferente. Para obter o valor do evento mapeado, consulte a propriedade Key .
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. (Herdado de RoutedEventArgs)

Confira também

• RoutedEventArgs
• Amostra do controle XAML WebView