CharacterReceivedEventArgs Classe

Définition

Espace de noms:

Windows.UI.Core

Fournit les arguments retournés par l’événement déclenché lorsqu’un caractère est reçu par la file d’attente d’entrée.

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

Héritage

Object Platform::Object IInspectable CharacterReceivedEventArgs

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Implémente

ICoreWindowEventArgs

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

Windows 10 Les applications ne reçoivent pas cet événement lorsqu’un éditeur de méthode d’entrée (IME) est activé. L’éditeur de méthode d’entrée (IME) gère toutes les entrées du clavier et définit Handled sur true.

Windows Phone Cette API est prise en charge dans les applications natives uniquement.

Cet objet est retourné par un délégué inscrit pour l’événement suivant :

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

Notes

Cette classe n’est pas agile, ce qui signifie que vous devez prendre en compte son modèle de thread et son comportement de marshaling. Pour plus d’informations, consultez Threading and Marshaling (C++/CX) .

Propriétés

Handled	Obtient ou définit si l’événement reçu par les caractères a été géré ou non.
KeyCode	Obtient le code clé du caractère reçu par la file d’attente d’entrée.
KeyStatus	Obtient la status de l’appui physique sur la touche qui a déclenché l’événement de réception de caractères.

Voir aussi

• CharacterReceived