Compartir a través de


Método IInkDisp::HitTestWithLasso (msinkaut.h)

Recupera los trazos dentro de un área de selección de polilínea.

Sintaxis

HRESULT HitTestWithLasso(
  [in]                VARIANT     Points,
  [in]                float       IntersectPercent,
  [in, out, optional] VARIANT     *LassoPoints,
  [out, retval]       IInkStrokes **Strokes
);

Parámetros

[in] Points

Puntos que se usan en la herramienta de selección para seleccionar los trazos. El área de selección es el área dentro del límite de selección en el que el límite se interseca primero. Si el límite no se interseca, el método agrega un punto al final de la matriz para crear una línea recta desde el primer punto hasta el último punto. Si el límite es una línea recta (sin área dentro del límite de selección), no se seleccionan trazos.

Para obtener más información sobre la estructura VARIANT, vea Uso de la biblioteca COM.

[in] IntersectPercent

Porcentaje de puntos de trazo que se deben incluir en la herramienta de selección para incluir el trazo en la colección resultante de trazos. Si es cero (0), todos los trazos contenidos dentro o intersecados por la herramienta de selección se incluyen en la colección resultante de trazos. Si es 100, solo se incluyen en la colección los trazos totalmente contenidos en la herramienta de selección. Los trazos que intersecan la herramienta de selección se incluyen en la colección si el porcentaje de puntos de esos trazos contenidos en la herramienta de selección es mayor o igual que el porcentaje percentIntersect . Los porcentajes fraccionarios se redondean hacia arriba.

[in, out, optional] LassoPoints

Opcional. Recupera la parte específica de la herramienta de selección que se usa para la selección. Dado que un usuario puede dibujar muchos tipos diferentes de herramientas de selección, algunas de las cuales se superponen varias veces, esto puede ser útil para ilustrar qué parte de la herramienta de selección se usó para la selección. El valor predeterminado es un puntero NULL , lo que significa que no se devuelve información.

Para obtener más información sobre la estructura VARIANT, vea Uso de la biblioteca COM.

[out, retval] Strokes

Cuando este método vuelve, contiene un puntero a la colección de trazos que componen la entrada de lápiz.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
Correcto.
E_POINTER
Un parámetro contenía un puntero no válido.
E_INK_EXCEPTION
Se produjo una excepción dentro del método .
E_INVALIDARG
Identificador de pantalla no válido.
E_OUTOFMEMORY
No se puede asignar la operación de memoria.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado msinkaut.h
Library InkObj.dll

Consulte también

HitTest(Point, Single) (Método)

HitTest(Rectangle, Single) (Método)

IInkDisp

InkDisp (clase)

Colección InkStrokes