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。

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

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

适用于

另请参阅