Ink.HitTest (Método) (array<Point[], Single, array<Point[]%)

Artículo
11/26/2008

Actualización: noviembre 2007

Devuelve la colección Strokes incluida dentro de un límite de selección de polilínea.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

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

Parámetros

points
Tipo: array<System.Drawing.Point[]
Los puntos que se usan en el límite de la selección para seleccionar los objetos Stroke. El área de selección es el área dentro del límite de la selección en la que el límite forma una intersección primero.

percentIntersect
Tipo: System.Single
Porcentaje por el que la intersección se debe superponer para que sea un acierto.

lassoPoints
Tipo: array<System.Drawing.Point[]%
Cuando este método realiza la devolución, contiene un parámetro out que representa la parte concreta del límite de la selección que se usa para la selección. Como un usuario puede dibujar muchos límites con forma diferentes, algunos de los cuales se superponen varias veces, esto puede resultar útil para mostrar qué parte del límite se usa para la selección. Este parámetro se pasa sin inicializar.

Valor devuelto

Tipo: Microsoft.Ink.Strokes
La colección Strokes incluida en el área especificada.

Comentarios

Si el límite de la selección no forma intersección consigo mismo, el método HitTest agrega un punto al final de la matriz para crear una línea recta desde el primer punto al último punto. Si el límite es una línea recta sin ningún área dentro del límite de la selección, no se selecciona ningún objeto Stroke.

Este método produce una excepción si el parámetro de puntos es nullreferencia null (Nothing en Visual Basic) (Nothing en Microsoft Visual Basic.NET) o contiene menos de tres puntos.

Ejemplos

En este ejemplo de C# se usa una matriz de objetos Point, theSelectionBoundary, para seleccionar una colección Strokes de un objeto Ink, theInk. El parámetro percentIntersect se establece en 50,0. Y así, un objeto Stroke debe tener al menos un 50 por ciento de sus puntos contenidos en el límite de la selección para incluirlos en la colección Strokes, theStrokes. Los puntos reales que se usan para seleccionar objetos Stroke se devuelven de una matriz de objetos Point, selectedPointsUsed.

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

En este ejemplo de Microsoft Visual Basic.NET se usa una matriz de objetos Point, theSelectionBoundary, para seleccionar una colección Strokes de un objeto Ink, theInk. El parámetro percentIntersect se establece en 50,0. Y así, un objeto Stroke debe tener al menos un 50 por ciento de sus puntos contenidos en el límite de la selección para incluirlos en la colección Strokes, theStrokes. Los puntos reales que se usan para seleccionar objetos Stroke se devuelven de una matriz de objetos Point, selectedPointsUsed.

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

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.