Ink.HitTest, méthode (array<Point[], Single, array<Point[]%)

Article
11/05/2008

Mise à jour : November 2007

Retourne la collection Strokes contenue dans les limites de la sélection polyligne.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public Function HitTest ( _
    points As Point(), _
    percentIntersect As Single, _
    <OutAttribute> ByRef lassoPoints As Point() _
) As Strokes
'Utilisation
Dim instance As Ink
Dim points As Point()
Dim percentIntersect As Single
Dim lassoPoints As Point()
Dim returnValue As Strokes

returnValue = instance.HitTest(points, _
    percentIntersect, lassoPoints)

public Strokes HitTest(
    Point[] points,
    float percentIntersect,
    out Point[] lassoPoints
)

public:
Strokes^ HitTest(
    array<Point>^ points, 
    float percentIntersect, 
    [OutAttribute] array<Point>^% lassoPoints
)

public Strokes HitTest(
    Point[] points,
    float percentIntersect,
    /** @attribute OutAttribute */ /** @ref */Point[] lassoPoints
)

public function HitTest(
    points : Point[], 
    percentIntersect : float, 
    lassoPoints : Point[]
) : Strokes

Paramètres

points
Type : array<System.Drawing.Point[]
Points utilisés dans les limites de la sélection pour sélectionner les objets Stroke. La zone de sélection est à l'intérieur des limites de la sélection, à leur première intersection.

percentIntersect
Type : System.Single
Pourcentage de chevauchement nécessaire pour constituer un positionnement.

lassoPoints
Type : array<System.Drawing.Point[]%
Lorsque cette méthode retourne un paramètre de sortie qui représente la partie spécifique de la limite de sélection utilisée pour la sélection. Comme un utilisateur peut dessiner des limites de formes très variées et qui peuvent se chevaucher plusieurs fois, ceci peut être utile pour montrer quelle partie de la limite est sélectionnée. Ce paramètre est passé sans être initialisé.

Valeur de retour

Type : Microsoft.Ink.Strokes
Collection Strokes contenue dans la zone spécifiée.

Notes

Si la limite de la sélection ne se recoupe pas, la méthode HitTest ajoute un point à la fin du tableau pour créer une ligne droite du premier au dernier point. Si la limite est une ligne droite sans zone dans la limite de sélection, aucun objet Stroke n'est sélectionné.

Cette méthode lève une exception si le paramètre des points a la valeur nullune référence null (Nothing en Visual Basic) (Nothing en Microsoft Visual Basic.NET) ou contient moins de trois points.

Exemples

Cet exemple C# utilise un tableau d'objets Point (page pouvant être en anglais), theSelectionBoundary, pour sélectionner une collection Strokes d'un objet Ink, theInk. Le paramètre percentIntersect a la valeur 50,0, donc au moins 50 % des points d'un objet Stroke situés dans la limite de sélection doivent être inclus dans la collection Strokes, theStrokes. Les points réels utilisés pour sélectionner les objets Stroke sont retournés dans un tableau d'objets Point (page pouvant être en anglais), selectedPointsUsed.

Strokes theStrokes = theInk.HitTest(theSelectionBoundary, 50.0f, selectedPointsUsed);

Cet exemple Microsoft Visual Basic.NET utilise un tableau d'objets Point (page pouvant être en anglais), theSelectionBoundary, pour sélectionner une collection Strokes d'un objet Ink, theInk. Le paramètre percentIntersect a la valeur 50,0, donc au moins 50 % des points d'un objet Stroke situés dans la limite de sélection doivent être inclus dans la collection Strokes, theStrokes. Les points réels utilisés pour sélectionner les objets Stroke sont retournés dans un tableau d'objets Point (page pouvant être en anglais), selectedPointsUsed.

Dim theStrokes As Strokes = theInk.HitTest(theSelectionBoundary, 50.0, selectedPointsUsed)

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.