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.

C#

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

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.

C#

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);
}

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.

C#

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

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.

C#

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);
}

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.