Partilhar via


KeyRoutedEventArgs Classe

Definição

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

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/RightGamepadDPadUp/Down/Left/Right ou NavigationUp/Down/Left/Right
GamePad Joystick/ThumbstickGamepadLeftThumbstickButton/Up/Down/Left/Right ou GamepadRightThumbstickButton/Up/Down/Left/RightGamepadLeftThumbstickButton/Up/Down/Left/Right ou GamepadRightThumbstickButton/Up/Down/Left/Right ou NavigationUp/Down/Left/Right
Gatilho do GamepadGamePadRightTrigger/LeftTriggerGamePadRightTrigger/LeftTrigger
Para-choque/ombro do gamepadGamePadRightShoulder/LeftShoulderGamePadRightShoulder/LeftShoulder
Botão Menu do GamepadGamepadMenuGamepadMenu ou NavigationMenu
Botão Modo de Exibição do GamepadGamepadViewGamepadView 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)

Aplica-se a

Confira também