UIElement.KeyUp 事件

  • 參考

定義

命名空間:
Windows.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 順序時取得焦點。 您也可以呼叫 Control.Focus，以程式設計方式將控制項焦點。

KeyUp 是路由事件。 如需路由事件概念的詳細資訊，請參閱 事件和路由事件概觀。

KeyUp 使用 KeyRoutedEventArgs 事件資料。 對大多數處理常式案例來說，最相關的 KeyRoutedEventArgs 屬性是 Key，也有可能是 KeyStatus。 如需處理鍵盤事件的詳細資訊，包括定義 KeyEventHandler 方法的範例程式碼，請參閱 鍵盤互動。

處理鍵盤事件的其中一個案例是支援應用程式的便捷鍵或快速鍵，或應用程式內的區域或控制項。 如需此案例的詳細資訊，請參閱 鍵盤協助工具。

特定Windows 執行階段控制項可能會有 KeyUp 輸入事件的類別型處理。 如果是，控制項可能具有 OnKeyUp方法的覆寫。 這些類別處理常式通常用來處理按鍵按下子集，以啟用與該控制項的鍵盤型使用者互動，而且此互動通常支援鍵盤協助工具功能。 如果鍵盤按鍵事件是由類別型處理所處理，則會將按鍵事件視為已經處理，而且不會引發 KeyUp 事件，以供該控制項上的任何使用者程式碼處理常式處理。 這通常只是針對一些專用金鑰。 例如， ButtonBase 具有類別處理，以便將空格鍵和 Enter 鍵當做鍵盤對等專案來處理，以叫用 Button。 這提供相當於點選按鈕或以滑鼠按一下按鈕的內建鍵盤，並啟用僅使用鍵盤使用 UI 和按鈕的協助工具案例。 但空格鍵或 Enter 以外的任何其他按鍵仍會引發Button的KeyDown和 KeyUp 事件。 如需事件類別型處理運作方式的詳細資訊，請參閱 事件和路由事件概觀。

KeyUp 支援將事件處理常式附加至將叫用的路由，即使事件的事件資料標示為 Handled 也一樣。 請參閱 AddHandler。

適用於

另請參閱