語言

UIElement.KeyUp 事件

定義

命名空間:
Microsoft.UI.Xaml
編輯

當 UIElement 正在對焦時放開鍵盤鍵時會發生。

public:
 virtual event KeyEventHandler ^ KeyUp;
// Register
event_token KeyUp(KeyEventHandler const& handler) const;

// Revoke with event_token
void KeyUp(event_token const* cookie) const;

// Revoke with event_revoker
UIElement::KeyUp_revoker KeyUp(auto_revoke_t, KeyEventHandler const& handler) const;
public event KeyEventHandler KeyUp;
function onKeyUp(eventArgs) { /* Your code */ }
uIElement.addEventListener("keyup", onKeyUp);
uIElement.removeEventListener("keyup", onKeyUp);
- or -
uIElement.onkeyup = onKeyUp;
Public Custom Event KeyUp As KeyEventHandler 
<uiElement KeyUp="eventhandler"/>

事件類型

KeyEventHandler

備註

UI 中的控制項只有在具有輸入焦點時才會產生鍵盤事件。 預設情況下，視覺樹中第一個可聚焦元素會由系統賦予焦點。 當使用者在版面配置中直接按一下或輕觸某個控制項，或使用 Tab 鍵逐步移入內容區域中的 Tab 順序時，該控制項就會取得焦點。 你也可以透過呼叫 UIElement.Focus（Microsoft.UI。Xaml.FocusState）。

KeyUp 是路由事件。 欲了解更多路由事件概念，請參閱 事件與路由事件總覽。

KeyUp 使用 KeyRoutedEventArgs 事件資料。 對於大多數處理器情境來說，最 KeyRoutedEventArgs 相關的屬性是 Key ，可能還有 KeyStatus。 關於處理鍵盤事件的更多資訊，包括定義 KeyEventHandler 方法的範例程式碼，請參見 鍵盤互動。

處理鍵盤事件的一種情境是支援應用程式的存取鍵或加速鍵，或應用程式內的區域或控制項。 欲了解更多此情境資訊，請參見 鍵盤無障礙。

特定的 Windows 執行階段 控制項可能對輸入事件採取類別式處理KeyUp。 如果是這樣，控制鍵大概有 OnKeyUp 方法的覆蓋。 通常這些類別處理器旨在處理部分按鍵操作，使使用者能以鍵盤操作該控制項，且此互動通常支援鍵盤無障礙功能。 若鍵盤鍵事件由類別處理，則該鍵事件視為已處理，且該 KeyUp 事件不會被該控制項的任何使用者程式碼處理器處理。 通常這只是針對幾個專用的按鍵。 例如， ButtonBase 有類別處理，讓 空白 鍵和 Enter 鍵作為呼叫按鈕的鍵盤對應 物來處理。 這內建了鍵盤的對應功能，方便點擊按鈕或滑鼠點擊，並實現僅用鍵盤操作介面與按鈕的無障礙體驗。 但除了空格或 Enter 以外的按鍵，仍然會觸發 KeyDown 和 KeyUp 事件。Button 關於基於類別的事件處理方式，請參閱 事件與路由事件總覽。

KeyUp 支援即使事件資料標記 為已處理，也能將事件處理器附加到將被呼叫的路由上。 請參見 AddHandler。

適用於

另請參閱