CharacterReceivedEventArgs クラス

定義

名前空間:

Windows.UI.Core

入力キューで文字を受信したときに発生するイベントによって返される引数を提供します。

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

継承

Object Platform::Object IInspectable CharacterReceivedEventArgs

属性

ContractVersionAttribute MarshalingBehaviorAttribute

実装

ICoreWindowEventArgs

Windows の要件

デバイス ファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

注釈

Windows 10アプリは、入力メソッド エディター (IME) が有効になっている場合、このイベントを受信しません。 入力メソッド エディター (IME) は、すべてのキーボード入力を処理し、 Handled を true に設定 します。

Windows Phone この API はネイティブ アプリでのみサポートされています。

このオブジェクトは、次のイベントに登録されているデリゲートによって返されます。

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

注意

このクラスはアジャイルではありません。つまり、スレッド モデルとマーシャリング動作を考慮する必要があります。 詳細については、「 スレッドとマーシャリング (C++/CX)」を参照してください。

プロパティ

Handled	文字受信イベントが処理されたかどうかを取得または設定します。
KeyCode	入力キューによって受信された文字のキー コードを取得します。
KeyStatus	文字受信イベントを発生させた物理キー押下の状態を取得します。

こちらもご覧ください

• CharacterReceived