UIElement.CharacterReceived イベント

  • リファレンス

定義

名前空間:
Windows.UI.Xaml
編集

1 つの構成済み文字が入力キューによって受信されたときに発生します。

// Register
event_token CharacterReceived(TypedEventHandler<UIElement, CharacterReceivedRoutedEventArgs const&> const& handler) const;

// Revoke with event_token
void CharacterReceived(event_token const* cookie) const;

// Revoke with event_revoker
UIElement::CharacterReceived_revoker CharacterReceived(auto_revoke_t, TypedEventHandler<UIElement, CharacterReceivedRoutedEventArgs const&> const& handler) const;
public event TypedEventHandler<UIElement,CharacterReceivedRoutedEventArgs> CharacterReceived;
function onCharacterReceived(eventArgs) { /* Your code */ }
uIElement.addEventListener("characterreceived", onCharacterReceived);
uIElement.removeEventListener("characterreceived", onCharacterReceived);
- or -
uIElement.oncharacterreceived = onCharacterReceived;
Public Custom Event CharacterReceived As TypedEventHandler(Of UIElement, CharacterReceivedRoutedEventArgs) 
<uiElement CharacterReceived="eventhandler"/>

イベントの種類

TypedEventHandler<UIElement,CharacterReceivedRoutedEventArgs>

Windows の要件

デバイス ファミリ
Windows 10 Fall Creators Update (10.0.16299.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v5.0 で導入)

注釈

注意

構成された文字は、1 つ以上の他の文字のシーケンスから派生した 1 つのビジュアル オブジェクトです。

CharacterReceived はルーティング イベントです。 ルーティング イベントの概念の詳細については、「 イベントとルーティング イベントの概要」を参照してください。

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

このイベントは、"typeahead find or search" (増分検索、増分検索、リアルタイム検索とも呼ばれます) などのテキスト入力シナリオで役立ちます。ユーザーが入力すると、コントロールは入力キュー内の文字に基づいてテキストを徐々に検索してフィルター処理します。

CharacterReceived イベントは、入力された文字が入力キューに登録されるまでイベントが発生されないため、入力した文字に応じて異なるタイミングで発生する可能性があります。

  • ユーザーが W キーを押します (文字 'w' を受け取ります):
    • W の PreviewKeyDown
    • W の KeyDown
    • CharacterReceived
    • PreviewKeyUp for W
    • W の KeyUp
  • ユーザーが Shift キーを押しながら W キーを押します (文字 'W' を受け取ります):
    • Shift の PreviewKeyDown
    • Shift の KeyDown
    • W の PreviewKeyDown
    • W の KeyDown
    • CharacterReceived
    • PreviewKeyUp for W
    • W の KeyUp
    • Shift の PreviewKeyUp
    • Shift キーの KeyUp
  • ユーザーが NumPad を使用して Alt キーを押しながら 164 キーを押します (文字 'ñ' を受け取ります)。
    • Alt の PreviewKeyDown
    • Alt の KeyDown
    • 1 の PreviewKeyDown
    • 1 の KeyDown
    • PreviewKeyUp for 1
    • KeyUp for 1
    • 6 の PreviewKeyDown
    • 6 の KeyDown
    • PreviewKeyUp for 6
    • KeyUp for 6
    • 4 の PreviewKeyDown
    • 4 の KeyDown
    • PreviewKeyUp for 4
    • KeyUp for 4
    • CharacterReceived
    • Alt の PreviewKeyUp
    • KeyUp for Alt

適用対象

こちらもご覧ください