言語

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>

注釈

Note

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

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

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

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

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

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

適用対象

こちらもご覧ください