Ink.HitTest-Methode (array<Point[], Single, array<Point[]%)

Artikel
11/26/2008

Gibt die innerhalb einer durch eine Polylinie definierte Auswahlbegrenzung enthaltene Strokes-Auflistung zurück.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Function HitTest ( _
    points As Point(), _
    percentIntersect As Single, _
    <OutAttribute> ByRef lassoPoints As Point() _
) As Strokes
'Usage
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

Parameter

points
Typ: array<System.Drawing.Point[]
Die Punkte, die in der Auswahlbegrenzung zur Auswahl der Stroke-Objekte dienen. Der Auswahlbereich ist der Bereich innerhalb der Auswahlbegrenzung, in dem sich die Begrenzung zuerst selbst schneidet.

percentIntersect
Typ: System.Single
Prozentsatz, um den sich die Schnittmenge überschneiden muss, um als Treffer zu gelten.

lassoPoints
Typ: array<System.Drawing.Point[]%
Wenn diese Methode einen Wert zurückgibt, enthält dieser einen Ausgabeparameter, der den speziellen Teil der Auswahlbegrenzung darstellt, der zur Auswahl verwendet wird. Weil ein Benutzer viele unterschiedlich geformten Begrenzungen zeichnen kann, von denen sich einige mehrfach überschneiden können, kann mithilfe dieser Methode veranschaulicht werden, welcher Teil der Begrenzung zur Auswahl verwendet wird. Dieser Parameter wird nicht initialisiert übergeben.

Rückgabewert

Typ: Microsoft.Ink.Strokes
Die Strokes-Auflistung, die im angegebenen Bereich enthalten ist.

Hinweise

Wenn sich die Auswahlbegrenzung nicht selbst schneidet, fügt die HitTest-Methode einen Punkt am Ende des Arrays hinzu, um eine gerade Linie vom ersten Punkt bis zum letzten Punkt zu erstellen. Wenn die Begrenzung eine gerade Linie ist, die nicht innerhalb der Auswahlbegrenzung liegt, dann werden keine Stroke-Objekte ausgewählt.

Diese Methode löst eine Ausnahme aus, wenn der Punkteparameter gleich nullNULL-Verweis (Nothing in Visual Basic) (Nothing in Microsoft Visual Basic.NET) ist oder weniger als drei Punkte enthält.

Beispiele

In diesem C#-Beispiel wird mithilfe eines Arrays von Point-Objekten namens theSelectionBoundary eine Strokes-Auflistung aus einem Ink-Objekt mit dem Namen theInk ausgewählt. Der percentIntersect-Parameter wird auf 50,0 festgelegt, sodass mindestens 50 Prozent der Punkte eines Stroke-Objekts innerhalb der Auswahlbegrenzung liegen müssen, damit das Objekt in die Strokes-Auflistung mit dem Namen theStrokes aufgenommen wird. Die eigentlichen Punkte, die zur Auswahl der Stroke-Objekte verwendet werden, werden in einem Array von Point-Objekten namens selectedPointsUsed zurückgegeben.

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

In diesem Microsoft® Visual Basic® .NET-Beispiel wird mithilfe eines Arrays von Point-Objekten namens theSelectionBoundary eine Strokes-Auflistung aus einem Ink-Objekt mit dem Namen theInk ausgewählt. Der percentIntersect-Parameter wird auf 50,0 festgelegt, sodass mindestens 50 Prozent der Punkte eines Stroke-Objekts innerhalb der Auswahlbegrenzung liegen müssen, damit das Objekt in die Strokes-Auflistung mit dem Namen theStrokes aufgenommen wird. Die eigentlichen Punkte, die zur Auswahl der Stroke-Objekte verwendet werden, werden in einem Array von Point-Objekten namens selectedPointsUsed zurückgegeben.

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

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.