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 キーを使ってコンテンツ領域内のタブ順に入ると、フォーカスを取得します。 Control.Focus を呼び出すことで、プログラムでコントロールにフォーカスを設定することもできます。

KeyUp はルーティング イベントです。 ルーティング イベントの概念の詳細については、「 イベントとルーティング イベントの概要」を参照してください。

KeyUp は KeyRoutedEventArgs イベント データを使用します。 ハンドラーに関するほとんどのシナリオで、最もよく使われる KeyRoutedEventArgs のプロパティは、Key です。場合によっては、KeyStatus も使われます。 KeyEventHandler メソッドを定義するためのコード例など、キーボード イベントの処理の詳細については、「キーボード操作」を参照してください。

キーボード イベントを処理するシナリオの 1 つは、アプリのアクセス キーまたはアクセラレータ キー、またはアプリ内のリージョンまたはコントロールをサポートすることです。 このシナリオの詳細については、「 キーボード アクセシビリティ」を参照してください。

特定のWindows ランタイム コントロールには、KeyUp 入力イベントのクラスベースの処理が含まれる場合があります。 その場合、コントロールには OnKeyUp メソッドのオーバーライドが含まれている可能性があります。 通常、これらのクラス ハンドラーは、そのコントロールとのキーボードベースのユーザー操作を可能にするキー押下のサブセットを処理することを目的としており、多くの場合、この操作ではキーボード アクセシビリティ機能がサポートされます。 キーボード キー イベントがクラスベースの処理によって処理される場合、キー イベントは既に処理されていると見なされ、そのコントロール上のユーザー コード ハンドラーによって処理される KeyUp イベントは発生しません。 通常、これはいくつかの専用キーのためだけに使用されます。 たとえば、 ButtonBase にはクラス処理があり、Space キーと Enter キーは Button を呼び出すためのキーボードと同等のものとして処理されます。 これにより、ボタンをタップしたり、マウスでクリックしたりするための組み込みのキーボードが提供され、UI とボタンをキーボードのみを使用するアクセシビリティ シナリオが可能になります。 ただし、Space または Enter 以外の他のキーでも、Button の KeyDown イベントと KeyUp イベントが発生 します。 イベントのクラスベースの処理のしくみの詳細については、「 イベントとルーティング イベントの概要」を参照してください。

KeyUp では、イベントのイベント データが Handled とマークされている場合でも、呼び出されるルートにイベント ハンドラーをアタッチする機能がサポートされています。 「 AddHandler」を参照してください。

適用対象

こちらもご覧ください