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

適用於

另請參閱