Stylus.Capture Método

Definição

Namespace:

System.Windows.Input

Assembly:

PresentationCore.dll

Captura a caneta associada a um determinado elemento.

Sobrecargas

Capture(IInputElement)	Captura a caneta para o elemento especificado.
Capture(IInputElement, CaptureMode)	Captura a caneta para o elemento especificado.

Capture(IInputElement)

Captura a caneta para o elemento especificado.

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

Parâmetros

element

IInputElement

O elemento para o qual a caneta será capturada.

Retornos

Boolean

true se a caneta for capturada para element; caso contrário, false.

Exemplos

O exemplo a seguir demonstra como registrar as coordenadas da caneta, mesmo que a caneta deixe os limites de um TextBox. Este exemplo pressupõe que há um TextBox chamado textBox1, e que os StylusDowneventos , StylusUpe StylusMove estão conectados a manipuladores de eventos.

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

Comentários

Use o Capture(IInputElement) método para garantir que element receba eventos de caneta mesmo quando o cursor sair dos limites dos elementos. Para liberar a caneta, chame Capture(IInputElement, CaptureMode) com o CaptureMode definido como None.

O Capture(IInputElement) método retornará false se element não estiver visível ou habilitado.

Capture(IInputElement, CaptureMode)

Captura a caneta para o elemento especificado.

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

Parâmetros

element

IInputElement

O elemento para o qual a caneta será capturada.

captureMode

CaptureMode

Um dos valores de CaptureMode.

Retornos

Boolean

true se a caneta for capturada para element; caso contrário, false.

Exemplos

O exemplo a seguir demonstra como registrar as coordenadas da caneta, mesmo que a caneta deixe os limites de um TextBox. Este exemplo pressupõe que há um TextBox chamado textBox1, e que os StylusDowneventos , StylusUpe StylusMove estão conectados aos manipuladores de eventos.

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

Comentários

Use o Capture(IInputElement, CaptureMode) método para garantir que element receba eventos de caneta mesmo quando o cursor sair dos limites dos elementos. Para liberar a caneta, chame Capture(IInputElement, CaptureMode) com o CaptureMode definido como None.

O Capture(IInputElement, CaptureMode) método retornará false se element não estiver visível ou habilitado.