UIElement.CharacterReceived 事件

定義

命名空間:

Windows.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>

Windows 需求

裝置系列	Windows 10 Fall Creators Update (已於 10.0.16299.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v5.0 引進)

備註

注意

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

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