CharacterReceivedEventArgs Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.UI.Core
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:

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