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

Artículo
03/05/2024

Recupera los trazos contenidos en un rectángulo especificado.

Sintaxis

HRESULT HitTestWithRectangle(
  [in]          IInkRectangle *SelectionRectangle,
  [in]          float         IntersectPercent,
  [out, retval] IInkStrokes   **Strokes
);

Parámetros

[in] SelectionRectangle

Rectángulo de selección, de tipo InkRectangle, en coordenadas de espacio de entrada de lápiz.

[in] IntersectPercent

Valor flotante o de porcentaje único que determina qué trazos se incluyen en la colección. Los trazos que intersectan el rectángulo se incluyen en la colección si el porcentaje de puntos de esos trazos contenidos en el rectángulo es mayor o igual que el porcentaje intersectPercent .

[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.

Comentarios

Para determinar qué puntos de un trazo conocido cruzan el área de prueba, llame al método GetRectangleIntersections del objeto IInkStrokeDisp , que recupera los puntos donde un trazo interseca un rectángulo conocido.

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