CharacterReceivedEventArgs Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.UI.Core

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Fornisce gli argomenti restituiti dall'evento generato quando un carattere viene ricevuto dalla coda di input.

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

Ereditarietà: Object Platform::Object IInspectable CharacterReceivedEventArgs

Attributi: ContractVersionAttribute MarshalingBehaviorAttribute

Implementazioni: ICoreWindowEventArgs

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

Windows 10 Le app non ricevono questo evento quando è abilitato un IME (Input Method Editor). Input Method Editor (IME) gestisce tutti gli input della tastiera e imposta Handled su true.

Windows Phone Questa API è supportata solo nelle app native.

Questo oggetto viene restituito da un delegato registrato per l'evento seguente:

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

Nota

Questa classe non è agile, il che significa che è necessario considerare il modello di threading e il comportamento di marshalling. Per altre info, vedi Threading e marshalling (C++/CX).

Proprietà

Handled	Ottiene o imposta un valore che indica se l'evento ricevuto dal carattere è stato gestito o meno.
KeyCode	Ottiene il codice chiave del carattere ricevuto dalla coda di input.
KeyStatus	Ottiene lo stato della pressione fisica del tasto che ha generato l'evento ricevuto dal carattere.

Si applica a

Vedi anche

CharacterReceived