Edit

Share via


Stylus.StylusButtonDown Attached Event

Definition

Occurs when the user presses one of the buttons on the stylus.

see AddStylusButtonDownHandler, and RemoveStylusButtonDownHandler
see AddStylusButtonDownHandler, and RemoveStylusButtonDownHandler
see AddStylusButtonDownHandler, and RemoveStylusButtonDownHandler

Examples

The following example demonstrates how to show a shortcut menu when the user presses the barrel button on a stylus. This example assumes that there is a TextBox called textBox1, and a ContextMenu called textBoxContextMenu, and that the StylusButtonDown event is connected to the event handler.

// Show or hide a shortcut menu when the user clicks the barrel button.
void textbox1_StylusButtonDown(object sender, StylusButtonEventArgs e)
{
    if (e.StylusButton.Guid != StylusPointProperties.BarrelButton.Id)
    {
        return;
    }

    if (textbox1.ContextMenu == null)
    {
        textbox1.ContextMenu = textBoxContextMenu;
    }
    else
    {
        textbox1.ContextMenu = null;
    }
}
' Show or hide a shortcut menu when the user clicks the barrel button.
Private Sub textbox1_StylusButtonDown(ByVal sender As Object, ByVal e As StylusButtonEventArgs) _
    Handles textbox1.StylusButtonDown

    If e.StylusButton.Guid <> StylusPointProperties.BarrelButton.Id Then
        Return
    End If

    If textbox1.ContextMenu Is Nothing Then
        textbox1.ContextMenu = textBoxContextMenu
    Else
        textbox1.ContextMenu = Nothing
    End If

End Sub

Remarks

This is an attached event. WPF implements attached events as routed events. An attached event is, fundamentally, a XAML language concept used to reference events that are handled on objects that do not, themselves, define events. WPF further expands an attached event's capabilities, allowing it to traverse a route. Attached events do not have a direct handling syntax in code; to attach handlers for a routed event in code, use a designated Add*Handler method. For details, see Attached Events Overview.

Routed Event Information

Item Value
Identifier field StylusButtonDownEvent
Routing strategy Bubbling
Delegate StylusButtonEventHandler

Applies to

See also