KeyUp

Arguments

AddEventListener Parameters

Event Handler Parameters

Managed Equivalent

KeyUp

Remarks

Note:
Handling keyboard events might vary between browsers. When you create an application that uses keyboard input, make sure to test the application in your target browsers.

You can also add handlers in script by using a quoted string for the event handler name, as follows:

object.AddEventListener("KeyUp", "eventhandlerFunction")

This syntax also returns a token. However, the token is not an absolute requirement for removing the handler in cases where the handler was added by using a quoted string. For details, see RemoveEventListener.

For a keyboard event to be received, the Silverlight plug-in or a specific control within it needs to have focus. Otherwise, the events are not generated. A Silverlight plug-in can gain focus by user actions such as clicking on or tabbing to the plug-in area. Alternatively, you can force focus to the Silverlight plug-in by calling the focus() method in the browser Document Object Model (DOM) when you handle the OnLoad event from instantiation script.

The KeyDown event always precedes a KeyUp event.

For more information on basic concepts, see Events Overview for Silverlight or Keyboard Support. Note that these topics are written primarily for users of the managed API, and may not have code examples or specific information that address the JavaScript API scenarios.

KeyUp is a bubbling event, so you can handle KeyUp on the control that received focus, or on any parent object (the parent object itself does not have to be focusable to receive the routed event).

Example

The following XAML example shows a KeyUp event defined for the root Canvas object.

<Canvas
  xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
  KeyUp="onKeyUp">

  <TextBlock
    x:Name="myTextBlock"
    Text="Display KeyUp event arguments" />

</Canvas>

The following JavaScript example shows how to implement a KeyUp event handler function. In this case, the Silverlight version is displayed when the keystroke combination CTRL+V is detected.

// Set the TextBlock to display the key values.
function onKeyUp(sender, keyEventArgs)
{
    // Determine whether the keystroke combination CTRL+V was detected.
    if ((keyEventArgs.key == 51) && (keyEventArgs.ctrl == true))
    {
       // Retrieve a reference to the plug-in.
       var plugin = sender.getHost();

       // Display whether the 1.0 version of Silverlight is supported.
       alert("Silverlight version: " + plugin.IsVersionSupported);
    }
}

Applies To

Border (Silverlight 2)

Canvas)

Grid (Silverlight 2)

PasswordBox (Silverlight 2)

Popup (Silverlight 2)

StackPanel (Silverlight 2)

TextBox (Silverlight 2)

See Also

Reference