UIElement.CharacterReceived 事件

定義

命名空間:

Microsoft.UI.Xaml

發生于輸入佇列收到單一撰寫字元時。

// 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>

備註

注意

組成字元是衍生自一或多個其他字元序列的單一視覺物件。

CharacterReceived 是路由事件。 如需路由事件概念的詳細資訊，請參閱 事件和路由事件概觀。

當啟用 輸入法編輯器 (輸入法) 時，應用程式不會收到此事件。 輸入法編輯器 (輸入法) 處理所有鍵盤輸入，並將 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
• 使用者按下 Alt+164， (收到字元 'ñ') ：
  • PreviewKeyDown for Alt
  • Alt 的 KeyDown
  • PreviewKeyDown for 1
  • 1 的 KeyDown
  • PreviewKeyUp for 1
  • KeyUp for 1
  • PreviewKeyDown for 6
  • 6 的 KeyDown
  • PreviewKeyUp for 6
  • KeyUp for 6
  • PreviewKeyDown for 4
  • KeyDown for 4
  • PreviewKeyUp for 4
  • KeyUp for 4
  • CharacterReceived
  • PreviewKeyUp for Alt
  • Alt 的 KeyUp

另請參閱

• CharacterReceivedRoutedEventArgs
• IsTextSearchEnabled