CharacterReceivedEventArgs Classe

Référence

Définition

Espace de noms:: Windows.UI.Core

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

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 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

C++/WinRT

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.

S’applique à

Produit	Versions
WinRT	Build 10240, Build 10586, Build 14383, Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100

Voir aussi

CharacterReceived

Partager via