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。

此事件对于文本输入方案（如“键入头查找或搜索”） (也称为增量搜索、增量查找或实时建议) 用户键入时，控件会根据输入队列中的字符逐步搜索和筛选文本。

CharacterReceived 事件可能在不同的时间发生，具体取决于输入的字符，因为直到组合字符在输入队列中注册后才会触发该事件。

• (收到字符“w”) ，用户按 W 键：
  • 适用于 W 的 PreviewKeyDown
  • 适用于 W 的 KeyDown
  • CharacterReceived
  • 适用于 W 的 PreviewKeyUp
  • KeyUp for W
• (收到字符“W”) ，用户按 Shift+W 键：
  • 适用于 Shift 的 PreviewKeyDown
  • Shift 的 KeyDown
  • 适用于 W 的 PreviewKeyDown
  • 适用于 W 的 KeyDown
  • CharacterReceived
  • 适用于 W 的 PreviewKeyUp
  • KeyUp for W
  • PreviewKeyUp for Shift
  • KeyUp for Shift
• 用户使用 NumPad 按 Alt+164， (收到字符“ñ”) ：
  • 适用于 Alt 的 PreviewKeyDown
  • Alt 的 KeyDown
  • PreviewKeyDown for 1
  • KeyDown for 1
  • PreviewKeyUp for 1
  • KeyUp for 1
  • PreviewKeyDown for 6
  • KeyDown for 6
  • PreviewKeyUp for 6
  • KeyUp for 6
  • PreviewKeyDown for 4
  • KeyDown for 4
  • PreviewKeyUp for 4
  • KeyUp for 4
  • CharacterReceived
  • 适用于 Alt 的 PreviewKeyUp
  • KeyUp for Alt

另请参阅

• CharacterReceivedRoutedEventArgs
• IsTextSearchEnabled