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

Aggiornamento: novembre 2007

Restituisce l'insieme Strokes contenuto all'interno di un limite di selezione di polilinea.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

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

Parametri

points
Tipo: array<System.Drawing.Point[]
Punti utilizzati nel limite di selezione per selezionare gli oggetti Stroke. L'area di selezione è l'area nel limite di selezione nel quale si interseca per prima il limite.

percentIntersect
Tipo: System.Single
Percentuale di sovrapposizione necessaria perché l'intersezione rientri nei risultati.

lassoPoints
Tipo: array<System.Drawing.Point[]%
Quando questo metodo restituisce, contiene un parametro out che rappresenta la parte specifica del limite di selezione utilizzato per la selezione. Dal momento che un utente può disegnare molti limiti formati in modo diverso, alcuni dei quali si sovrappongono più volte, ciò può essere utile per illustrare quale parte del limite è utilizzata per la selezione. Questo parametro viene passato senza inizializzazione.

Valore restituito

Tipo: Microsoft.Ink.Strokes
Insieme Strokes contenuto nell'area specificata.

Note

Se il limite di selezione non si interseca, il metodo HitTest aggiunge un punto alla fine della matrice per creare una linea retta dal primo all'ultimo punto. Se il limite è una linea retta senza area all'interno del limite di selezione, non viene selezionato alcun oggetto Stroke.

Questo metodo genera un'eccezione se il parametro dei punti è nullriferimento null (Nothing in Visual Basic) (Nothing in Microsoft Visual Basic.NET) o contiene meno di tre punti.

Esempi

In questo esempio di C# viene utilizzata una matrice di oggetti Point, theSelectionBoundary, per selezionare un insieme Strokes da un oggetto Ink, theInk. Il parametro percentIntersect è impostato su 50,0, pertanto un oggetto Stroke deve avere almeno il 50 percento dei punti contenuti all'interno del limite di selezione per essere incluso nell'insieme Strokes, theStrokes. I punti effettivi utilizzati per selezionare gli oggetti Stroke vengono restituiti in una matrice di oggetti Point, selectedPointsUsed.

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

In questo esempio di Microsoft Visual Basic.NET viene utilizzata una matrice di oggetti Point, theSelectionBoundary, per selezionare un insieme Strokes da un oggetto Ink, theInk. Il parametro percentIntersect è impostato su 50,0, pertanto un oggetto Stroke deve avere almeno il 50 percento dei punti contenuti all'interno del limite di selezione per essere incluso nell'insieme Strokes, theStrokes. I punti effettivi utilizzati per selezionare gli oggetti Stroke vengono restituiti in una matrice di oggetti Point, selectedPointsUsed.

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

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.