CharacterReceivedEventArgs クラス

リファレンス

定義

名前空間:: Windows.UI.Core

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

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

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