Stylus.Capture Methode

Definition

Namespace:

System.Windows.Input

Assembly:

PresentationCore.dll

Zeichnet den Tablettstift auf, der an ein bestimmtes Element gebunden ist.

Überlädt

Capture(IInputElement)	Zeichnet den Tablettstift für das angegebene Element auf.
Capture(IInputElement, CaptureMode)	Zeichnet den Tablettstift für das angegebene Element auf.

Capture(IInputElement)

Zeichnet den Tablettstift für das angegebene Element auf.

public:
 static bool Capture(System::Windows::IInputElement ^ element);

public static bool Capture (System.Windows.IInputElement element);

static member Capture : System.Windows.IInputElement -> bool

Public Shared Function Capture (element As IInputElement) As Boolean

Parameter

element

IInputElement

Das Element, für das der Tablettstift aufgezeichnet werden soll.

Gibt zurück

Boolean

true, wenn der Tablettstift für element aufgezeichnet wird, andernfalls false.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die Koordinaten des Tablettstifts auch dann erfasst werden, wenn der Tablettstift die Grenzen eines TextBoxverlässt. In diesem Beispiel wird davon ausgegangen, dass es einen TextBox namens textBox1gibt und dass die StylusDownEreignisse , StylusUpund StylusMove mit Ereignishandlern verbunden sind.

void textbox1_StylusDown(object sender, StylusDownEventArgs e)
{
    Stylus.Capture(textbox1);
}

void textbox1_StylusMove(object sender, StylusEventArgs e)
{
    Point pos = e.GetPosition(textbox1);
    textbox1.AppendText("X: " + pos.X + " Y: " + pos.Y + "\n");
}

void textbox1_StylusUp(object sender, StylusEventArgs e)
{
    Stylus.Capture(textbox1, CaptureMode.None);
}

Private Sub textbox1_StylusDown(ByVal sender As Object, ByVal e As System.Windows.Input.StylusDownEventArgs) _
    Handles textbox1.StylusDown

    Stylus.Capture(textbox1)

End Sub


Private Sub textbox1_StylusMove(ByVal sender As Object, ByVal e As StylusEventArgs) _
    Handles textbox1.StylusMove

    Dim pos As Point = e.GetPosition(textbox1)
    textbox1.AppendText("X: " & pos.X.ToString() & " Y: " & pos.Y.ToString() & vbLf)

End Sub


Private Sub textbox1_StylusUp(ByVal sender As Object, ByVal e As StylusEventArgs) _
    Handles textbox1.StylusUp

    Stylus.Capture(textbox1, CaptureMode.None)

End Sub

Hinweise

Verwenden Sie die Capture(IInputElement) -Methode, um sicherzustellen, dass element Tablettstiftereignisse auch dann empfangen, wenn der Cursor die Begrenzungen der Elemente überschreitet. Rufen Capture(IInputElement, CaptureMode) Sie zum Freigeben des Eingabestifts auf, wobei auf CaptureModeNonefestgelegt ist.

Die Capture(IInputElement) -Methode gibt zurück false , wenn element nicht sichtbar oder aktiviert ist.

Capture(IInputElement, CaptureMode)

Zeichnet den Tablettstift für das angegebene Element auf.

public:
 static bool Capture(System::Windows::IInputElement ^ element, System::Windows::Input::CaptureMode captureMode);

public static bool Capture (System.Windows.IInputElement element, System.Windows.Input.CaptureMode captureMode);

static member Capture : System.Windows.IInputElement * System.Windows.Input.CaptureMode -> bool

Public Shared Function Capture (element As IInputElement, captureMode As CaptureMode) As Boolean

Parameter

element

IInputElement

Das Element, für das der Tablettstift aufgezeichnet werden soll.

captureMode

CaptureMode

Einer der CaptureMode-Werte.

Gibt zurück

Boolean

true, wenn der Tablettstift für element aufgezeichnet wird, andernfalls false.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die Koordinaten des Tablettstifts auch dann erfasst werden, wenn der Tablettstift die Grenzen eines TextBoxverlässt. In diesem Beispiel wird davon ausgegangen, dass es einen TextBox namens textBox1gibt und dass die StylusDownEreignisse , StylusUpund StylusMove mit den Ereignishandlern verbunden sind.

void textbox1_StylusDown(object sender, StylusDownEventArgs e)
{
    Stylus.Capture(textbox1);
}

void textbox1_StylusMove(object sender, StylusEventArgs e)
{
    Point pos = e.GetPosition(textbox1);
    textbox1.AppendText("X: " + pos.X + " Y: " + pos.Y + "\n");
}

void textbox1_StylusUp(object sender, StylusEventArgs e)
{
    Stylus.Capture(textbox1, CaptureMode.None);
}

Private Sub textbox1_StylusDown(ByVal sender As Object, ByVal e As System.Windows.Input.StylusDownEventArgs) _
    Handles textbox1.StylusDown

    Stylus.Capture(textbox1)

End Sub


Private Sub textbox1_StylusMove(ByVal sender As Object, ByVal e As StylusEventArgs) _
    Handles textbox1.StylusMove

    Dim pos As Point = e.GetPosition(textbox1)
    textbox1.AppendText("X: " & pos.X.ToString() & " Y: " & pos.Y.ToString() & vbLf)

End Sub


Private Sub textbox1_StylusUp(ByVal sender As Object, ByVal e As StylusEventArgs) _
    Handles textbox1.StylusUp

    Stylus.Capture(textbox1, CaptureMode.None)

End Sub

Hinweise

Verwenden Sie die Capture(IInputElement, CaptureMode) -Methode, um sicherzustellen, dass element Tablettstiftereignisse auch dann empfangen, wenn der Cursor die Begrenzungen der Elemente überschreitet. Rufen Capture(IInputElement, CaptureMode) Sie zum Freigeben des Eingabestifts auf, wobei auf CaptureModeNonefestgelegt ist.

Die Capture(IInputElement, CaptureMode) -Methode gibt zurück false , wenn element nicht sichtbar oder aktiviert ist.