KeyEventArgs Class

Definition

Fornece dados para os eventos roteados KeyUp e KeyDown, bem como eventos de Versão Prévia e anexados relacionados.Provides data for the KeyUp and KeyDown routed events, as well as related attached and Preview events.

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
Inheritance

Remarks

Essa classe de dados de evento é usada com os seguintes eventos anexados:This event data class is used with the following attached events:

Essa classe de dados de evento também é usada com os seguintes eventos roteados em elementos base.This event data class is also used with the following routed events on base elements. Esses eventos roteados encaminham os eventos anexados anteriormente listados para torná-los mais acessíveis para o modelo de elemento geral no WPFWPF.These routed events forward the previously listed attached events to make them more accessible to the general element model in WPFWPF.

Os eventos anexados e os eventos roteados do elemento base compartilham seus dados de evento e as versões de bolha e de encapsulamento dos eventos roteados também compartilham dados de evento.The attached events and the base element routed events share their event data, and the bubbling and tunneling versions of the routed events also share event data. Isso pode afetar as características manipuladas do evento à medida que ele viaja para a rota de eventos.This can affect the handled characteristics of the event as it travels the event route. Para obter detalhes, consulte visão geral de entrada.For details, see Input Overview.

Uma chave pode estar nos Estados up e Toggle ou nos Estados pressionados e alternados.A key can be in both the up and toggled states or the down and toggled states. Por esse motivo, determinar se uma chave está para cima ou para baixo não é tão simples quanto verificar o valor de KeyStates como um valor numérico.For this reason, determining whether a key is up or down is not as simple as checking the KeyStates value as a numeric value. Em vez disso, você deve verificar o valor tratando-o como uma enumeração de sinalizador.Instead, you should check the value by treating it as a flag enumeration. Use uma comparação de AND do primeiro bit.Use an AND comparison of the first bit. Como alternativa, use as propriedades auxiliares IsUp, IsDowne IsToggled para determinar se uma determinada chave está ativa, inativa ou alternada.Alternatively, use the helper properties IsUp, IsDown, and IsToggled to determine whether a given key is up, down, or toggled.

Constructors

KeyEventArgs(KeyboardDevice, PresentationSource, Int32, Key)

Inicia uma nova instância da classe KeyEventArgs.Initializes a new instance of the KeyEventArgs class.

Properties

DeadCharProcessedKey

Obtém a chave que faz parte da composição de tecla inativa para criar um único caractere combinado.Gets the key that is part of dead key composition to create a single combined character.

Device

Obtém o dispositivo de entrada que iniciou esse evento.Gets the input device that initiated this event.

(Inherited from 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.Gets or sets a value that indicates the present state of the event handling for a routed event as it travels the route.

(Inherited from RoutedEventArgs)
ImeProcessedKey

Obtém a tecla do teclado referenciada pelo evento, se a tecla tiver sido processada por um Input Method Editor (IME)Input Method Editor (IME).Gets the keyboard key referenced by the event, if the key will be processed by an Input Method Editor (IME)Input Method Editor (IME).

InputSource

Obtém a origem de entrada que forneceu essa entrada.Gets the input source that provided this input.

IsDown

Obtém um valor que indica se a tecla referenciada pelo evento está no estado pressionado.Gets a value that indicates whether the key referenced by the event is in the down state.

IsRepeat

Obtém um valor que indica se a tecla do teclado referenciada pelo evento é uma tecla repetida.Gets a value that indicates whether the keyboard key referenced by the event is a repeated key.

IsToggled

Obtém um valor que indica se a chave referenciada pelo evento está no estado alternado.Gets a value that indicates whether the key referenced by the event is in the toggled state.

IsUp

Obtém um valor que indica se a tecla referenciada pelo evento está no estado ativo.Gets a value that indicates whether the key referenced by the event is in the up state.

Key

Obtém a tecla do teclado associada ao evento.Gets the keyboard key associated with the event.

KeyboardDevice

O dispositivo de teclado lógico associado ao evento de entrada.Gets the keyboard device associated with the input event.

(Inherited from KeyboardEventArgs)
KeyStates

Obtém o estado da tecla do teclado associada a este evento.Gets the state of the keyboard key associated with this event.

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.Gets the original reporting source as determined by pure hit testing, before any possible Source adjustment by a parent class.

(Inherited from RoutedEventArgs)
RoutedEvent

Obtém ou define o RoutedEvent associado a esta instância do RoutedEventArgs.Gets or sets the RoutedEvent associated with this RoutedEventArgs instance.

(Inherited from RoutedEventArgs)
Source

Obtém ou define uma referência ao objeto que ativou o evento.Gets or sets a reference to the object that raised the event.

(Inherited from RoutedEventArgs)
SystemKey

Obterá a chave de teclado referenciada pelo evento, se a chave for processada pelo sistema.Gets the keyboard key referenced by the event, if the key will be processed by the system.

Timestamp

Obtém a hora em que esse evento ocorreu.Gets the time when this event occurred.

(Inherited from InputEventArgs)

Methods

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Inherited from Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Inherited from Object)
InvokeEventHandler(Delegate, Object)

Invoca manipuladores de eventos em uma forma específica de tipo, que pode aumentar a eficiência do sistema de eventos.Invokes event handlers in a type-specific way, which can increase event system efficiency.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Inherited from 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.When overridden in a derived class, provides a notification callback entry point whenever the value of the Source property of an instance changes.

(Inherited from RoutedEventArgs)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Inherited from Object)

Applies to

See also