CharacterReceivedEventArgs Klasse

Referenz

Definition

Namespace:: Windows.UI.Core

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Stellt die Argumente bereit, die vom Ereignis zurückgegeben werden, das ausgelöst wird, wenn ein Zeichen von der Eingabewarteschlange empfangen wird.

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

Vererbung: Object Platform::Object IInspectable CharacterReceivedEventArgs

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute

Implementiert: ICoreWindowEventArgs

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Windows 10 Apps erhalten dieses Ereignis nicht, wenn ein Eingabemethoden-Editor (IME) aktiviert ist. Der Eingabemethoden-Editor (IME) verarbeitet alle Tastatureingaben und legt Handled auf true fest.

Windows Phone Diese API wird nur in nativen Apps unterstützt.

Dieses Objekt wird von einem Delegat zurückgegeben, der für das folgende Ereignis registriert ist:

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

Hinweis

Diese Klasse ist nicht agil, was bedeutet, dass Sie das Threadingmodell und das Marshallverhalten berücksichtigen müssen. Weitere Informationen finden Sie unter Threading und Marshalling (C++/CX).

Eigenschaften

Handled	Ruft ab oder legt fest, ob das Zeichen empfangene Ereignis behandelt wurde oder nicht.
KeyCode	Ruft den Schlüsselcode des Zeichens ab, das von der Eingabewarteschlange empfangen wird.
KeyStatus	Ruft die status des physischen Tastendrucks ab, durch den das Zeichen empfangene Ereignis ausgelöst wurde.

Gilt für:

Weitere Informationen

CharacterReceived

Freigeben über