Stylus.Capture Méthode

Définition

Espace de noms:

System.Windows.Input

Assembly:

PresentationCore.dll

Capture le stylet qui est lié à un élément particulier.

Surcharges

Capture(IInputElement)	Capture le stylet pour l'élément spécifié.
Capture(IInputElement, CaptureMode)	Capture le stylet pour l'élément spécifié.

Capture(IInputElement)

Capture le stylet pour l'élément spécifié.

C#

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

Paramètres

element

IInputElement

Élément pour capturer le stylet.

Retours

Boolean

true si le stylet est capturé pour element ; sinon, false.

Exemples

L’exemple suivant montre comment enregistrer les coordonnées du stylet, même si le stylet quitte les limites d’un TextBox. Cet exemple suppose qu’il existe un TextBox appelé textBox1, et que les StylusDownévénements , StylusUpet StylusMove sont connectés à des gestionnaires d’événements.

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

Remarques

Utilisez la Capture(IInputElement) méthode pour vous assurer que element reçoit des événements de stylet même lorsque le curseur sort des limites des éléments. Pour libérer le stylet, appelez Capture(IInputElement, CaptureMode) avec la CaptureMode valeur définie sur None.

La Capture(IInputElement) méthode retourne false si element n’est pas visible ou activé.

Capture(IInputElement, CaptureMode)

Capture le stylet pour l'élément spécifié.

C#

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

Paramètres

element

IInputElement

Élément pour capturer le stylet.

captureMode

CaptureMode

Une des valeurs de l'objet CaptureMode.

Retours

Boolean

true si le stylet est capturé pour element ; sinon, false.

Exemples

L’exemple suivant montre comment enregistrer les coordonnées du stylet, même si le stylet quitte les limites d’un TextBox. Cet exemple suppose qu’il existe un TextBox appelé textBox1et que les StylusDownévénements , StylusUpet StylusMove sont connectés aux gestionnaires d’événements.

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

Remarques

Utilisez la Capture(IInputElement, CaptureMode) méthode pour vous assurer que element reçoit des événements de stylet même lorsque le curseur sort des limites des éléments. Pour libérer le stylet, appelez Capture(IInputElement, CaptureMode) avec la CaptureMode valeur définie sur None.

La Capture(IInputElement, CaptureMode) méthode retourne false si element n’est pas visible ou activé.