CharacterReceivedEventArgs Clase

Definición

Proporciona los argumentos devueltos por el evento generado cuando la cola de entrada recibe un carácter.

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
Herencia
Object Platform::Object IInspectable CharacterReceivedEventArgs
Atributos
Implementaciones

Requisitos de Windows

Familia de dispositivos
Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

Windows 10 Las aplicaciones no reciben este evento cuando se habilita un Editor de métodos de entrada (IME). El Editor de métodos de entrada (IME) controla todas las entradas de teclado y establece Handled entrue.

Windows Phone Esta API solo se admite en aplicaciones nativas.

Un delegado registrado para el siguiente evento devuelve este objeto:

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);
    // ...
}

Nota

Esta clase no es ágil, lo que significa que debe tener en cuenta su modelo de subprocesos y el comportamiento de serialización. Para obtener más información, consulta Subprocesos y serialización (C++/CX).

Propiedades

Handled

Obtiene o establece si el evento recibido por caracteres se controló o no.

KeyCode

Obtiene el código de clave del carácter recibido por la cola de entrada.

KeyStatus

Obtiene el estado de la tecla física que generó el evento recibido por caracteres.

Se aplica a

Consulte también