KeyEventArgs Classe

Definição

Namespace:

System.Windows.Input

Assembly:

PresentationCore.dll

Fornece dados para os eventos roteados KeyUp e KeyDown, bem como eventos de Versão Prévia e anexados relacionados.

public ref class KeyEventArgs : System::Windows::Input::KeyboardEventArgs

public class KeyEventArgs : System.Windows.Input.KeyboardEventArgs

type KeyEventArgs = class
    inherit KeyboardEventArgs

Public Class KeyEventArgs
Inherits KeyboardEventArgs

Herança

Object

EventArgs

RoutedEventArgs

InputEventArgs

KeyboardEventArgs

KeyEventArgs

Comentários

Essa classe de dados de evento é usada com os seguintes eventos anexados:

• Keyboard.KeyUp

• Keyboard.KeyDown

• Keyboard.PreviewKeyUp

• Keyboard.PreviewKeyDown

Essa classe de dados de evento também é usada com os seguintes eventos roteado em elementos base. Esses eventos roteados encaminham os eventos anexados listados anteriormente para torná-los mais acessíveis ao modelo de elemento geral no WPF.

• UIElement.KeyUp

• UIElement.KeyDown

• UIElement.PreviewKeyUp

• UIElement.PreviewKeyDown

• ContentElement.KeyUp

• ContentElement.KeyDown

• ContentElement.PreviewKeyUp

• ContentElement.PreviewKeyDown

Os eventos anexados e os eventos roteados do elemento base compartilham seus dados de evento e as versões de borbulha e túnel dos eventos roteados também compartilham dados de eventos. Isso pode afetar as características tratadas do evento à medida que ele percorre a rota do evento. Para obter detalhes, consulte Visão geral da entrada.

Uma chave pode estar nos estados para cima e alternados ou nos estados para baixo e alternados. Por esse motivo, determinar se uma chave está para cima ou para baixo não é tão simples quanto verificar o KeyStates valor como um valor numérico. Em vez disso, você deve marcar o valor tratando-o como uma enumeração de sinalizador. Use uma AND comparação do primeiro bit. Como alternativa, use as propriedades auxiliares IsUp, IsDowne IsToggled para determinar se uma determinada chave está para cima, para baixo ou alternada.

Construtores

KeyEventArgs(KeyboardDevice, PresentationSource, Int32, Key)

Inicializa uma nova instância da classe KeyEventArgs.

Propriedades

DeadCharProcessedKey	Obtém a chave que faz parte da composição de tecla inativa para criar um único caractere combinado.
Device	Obtém o dispositivo de entrada que iniciou esse evento. (Herdado de InputEventArgs)
Handled	Obtém ou define um valor que indica o estado atual de manipulação de eventos para um evento roteado enquanto ele trafega na rota. (Herdado de RoutedEventArgs)
ImeProcessedKey	Obtém a tecla de teclado referenciada pelo evento, se a tecla for processada por um IME (Editor de Método de Entrada).
InputSource	Obtém a origem de entrada que forneceu essa entrada.
IsDown	Obtém um valor que indica se a tecla referenciada pelo evento está no estado pressionado.
IsRepeat	Obtém um valor que indica se a tecla do teclado referenciada pelo evento é uma tecla repetida.
IsToggled	Obtém um valor que indica se a chave referenciada pelo evento está no estado alternado.
IsUp	Obtém um valor que indica se a tecla referenciada pelo evento está no estado ativo.
Key	Obtém a tecla do teclado associada ao evento.
KeyboardDevice	O dispositivo de teclado lógico associado ao evento de entrada. (Herdado de KeyboardEventArgs)
KeyStates	Obtém o estado da tecla do teclado associada a este evento.
OriginalSource	Obtém a origem de relatório original conforme determinada pelo teste de clique puro, antes de qualquer ajuste possível da Source por parte de uma classe pai. (Herdado de RoutedEventArgs)
RoutedEvent	Obtém ou define o RoutedEvent associado a esta instância do RoutedEventArgs. (Herdado de RoutedEventArgs)
Source	Obtém ou define uma referência ao objeto que ativou o evento. (Herdado de RoutedEventArgs)
SystemKey	Obterá a chave de teclado referenciada pelo evento, se a chave for processada pelo sistema.
Timestamp	Obtém a hora em que esse evento ocorreu. (Herdado de InputEventArgs)

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InvokeEventHandler(Delegate, Object)	Invoca manipuladores de eventos em uma forma específica de tipo, o que pode aumentar a eficiência do sistema de eventos.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnSetSource(Object)	Quando substituído em uma classe derivada, fornece um ponto de entrada de retorno de chamada de notificação sempre que o valor da propriedade Source de uma instância muda. (Herdado de RoutedEventArgs)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• KeyEventHandler
• KeyboardEventArgs
• KeyboardEventHandler