Stylus.GotStylusCapture 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 an element captures the stylus events.
see AddGotStylusCaptureHandler, and RemoveGotStylusCaptureHandlersee AddGotStylusCaptureHandler, and RemoveGotStylusCaptureHandlersee AddGotStylusCaptureHandler, and RemoveGotStylusCaptureHandlerExamples
The following example demonstrates how to change the background color of a TextBox when the TextBox captures and releases stylus events. This example assumes that there is a textbox called textBox1, and that the GotStylusCapture and LostStylusCapture events are connected to event handlers.
void textbox1_LostStylusCapture(object sender, StylusEventArgs e)
{
textbox1.Background = Brushes.White;
}
void textbox1_GotStylusCapture(object sender, StylusEventArgs e)
{
textbox1.Background = Brushes.Red;
}
Private Sub textbox1_LostStylusCapture(ByVal sender As Object, ByVal e As StylusEventArgs) _
Handles textbox1.LostStylusCapture
textbox1.Background = Brushes.White
End Sub
Private Sub textbox1_GotStylusCapture(ByVal sender As Object, ByVal e As StylusEventArgs) _
Handles textbox1.GotStylusCapture
textbox1.Background = Brushes.Red
End Sub
Remarks
This is an attached event. WPF implements attached events as routed events. Attached events are, fundamentally, a XAML language concept used to reference events that are handled on objects that do not, themselves, define events. The 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 | GotStylusCaptureEvent |
| Routing strategy | Bubbling |
| Delegate | StylusEventHandler |
