CharacterReceivedEventArgs Klasse

  • Referenz

Definition

Namespace:
Windows.UI.Core
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:

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