UIElement.CharacterReceived イベント

  • リファレンス

定義

名前空間:
Microsoft.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>

注釈

注意

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

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

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

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

CharacterReceived イベントは、入力された文字によって異なるタイミングで発生する可能性があります。これは、構成された文字が入力キューに登録されるまでイベントは発生しません。

  • ユーザーが W キーを押します (文字 'w' を受け取ります)。
    • W の PreviewKeyDown
    • W の KeyDown
    • CharacterReceived
    • W の PreviewKeyUp
    • W の KeyUp
  • ユーザーが Shift キーを押しながら W キーを押します (文字 'W' を受け取ります)。
    • Shift の PreviewKeyDown
    • Shift の KeyDown
    • W の PreviewKeyDown
    • W の KeyDown
    • CharacterReceived
    • W の PreviewKeyUp
    • 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
    • PreviewKeyUp for Alt
    • KeyUp for Alt

適用対象

こちらもご覧ください