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

Recupera la colección InkStrokes que está completamente dentro o intersecada por un círculo conocido.

Sintaxis

HRESULT HitTestCircle(
  [in]          long        X,
  [in]          long        Y,
  [in]          float       radius,
  [out, retval] IInkStrokes **Strokes
);

Parámetros

[in] X

Posición x del centro del círculo de prueba de posicionamiento en unidades de espacio de tinta.

[in] Y

Posición y del centro del círculo de prueba de posicionamiento en unidades de espacio de tinta.

[in] radius

Radio del círculo que se va a usar en la prueba de posicionamiento, en unidades de espacio de tinta.

[out, retval] Strokes

Cuando este método devuelve, contiene la colección de trazos que están completamente dentro o intersecdos por el círculo especificado.

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_UNEXPECTED	Parámetro o tipo de propiedad inesperados.

Comentarios

Si un trazo interseca el círculo, se devuelve el trazo completo.

El método calcula la intersección, teniendo en cuenta el conjunto completo de atributos de dibujo que se aplican al trazo, incluido el ancho completo del lápiz, el suavizado Bezier (si está presente) y la forma de la punta del lápiz.

Después de realizar una rotación o transformación de rectálado en un trazo o en una colección de trazos, las coordenadas y y- transformadas x- ya no son concéntricas con las coordenadas originales. Por este motivo, el radius argumento no se debe calcular a partir de las x- coordenadas o y- .

Para determinar qué puntos de un trazo conocido interseca el área de prueba, llame al método HitTest del objeto IInkStrokeDisp .

La aplicación siempre debe pasar un puntero de destino para la colección resultante de trazos. Si no hay intersecciones, la colección tiene un recuento de cero.

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