Stylus.StylusButtonDown Attached Event
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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 |