CharacterReceivedEventArgs Classe

Definição

Namespace:

Windows.UI.Core

Fornece os argumentos retornados pelo evento gerado quando um caractere é recebido pela fila de entrada.

public ref class CharacterReceivedEventArgs sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class CharacterReceivedEventArgs final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class CharacterReceivedEventArgs

Public NotInheritable Class CharacterReceivedEventArgs

Herança

Object Platform::Object IInspectable CharacterReceivedEventArgs

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementações

ICoreWindowEventArgs

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

Windows 10 Os aplicativos não recebem esse evento quando um IME (Editor de Método de Entrada) está habilitado. O IME (Editor de Método de Entrada) manipula todas as entradas de teclado e define Handled como true.

Windows Phone Essa API tem suporte apenas em aplicativos nativos.

Esse objeto é retornado por um delegado registrado para o seguinte evento:

• CoreWindow.CharacterReceived

void SetWindow(CoreWindow const& window)
{
    ...
    window.CharacterReceived({this, &App::OnCharacterReceived });
}

// Character received event data in CharacterReceivedEventArgs.
void OnCharacterReceived(
    Windows::UI::Core::CoreWindow const& /* sender */,
    Windows::UI::Core::CharacterReceivedEventArgs const& /* args */)
{
}

// returning character received events data through CharacterReceivedEventArgs

void MyCoreWindowEvents::SetWindow( // implementation called by CoreApplication::Run(), provided for context
    _In_ CoreWindow^ window
    )
{
    // ...
    window->CharacterReceived +=
        ref new TypedEventHandler<CoreWindow^, CharacterReceivedEventArgs^>(this, &CoreWindowEvents::OnCharacterReceived);
    // ...
}

Observação

Essa classe não é ágil, o que significa que você precisa considerar seu modelo de threading e o comportamento de marshaling. Para obter mais informações, consulte Threading e marshaling (C++/CX).

Propriedades

Handled	Obtém ou define se o evento recebido por caracteres foi manipulado ou não.
KeyCode	Obtém o código de chave do caractere recebido pela fila de entrada.
KeyStatus	Obtém o status da tecla física que gerou o evento recebido pelo caractere.

Confira também

• CharacterReceived