Método IInkStrokeDisp::GetRectangleIntersections (msinkaut.h)

Busca los puntos donde un objeto IInkStrokeDisp interseca un rectángulo determinado.

Sintaxis

HRESULT GetRectangleIntersections(
  [in]          IInkRectangle *Rectangle,
  [out, retval] VARIANT       *Intersections
);

Parámetros

[in] Rectangle

Rectángulo en coordenadas de espacio de entrada de lápiz , que describe el área de prueba de posicionamiento.

[out, retval] Intersections

Cuando este método finaliza, contiene una matriz VARIANT que indica dónde interseca el trazo el rectángulo. Los índices de punto flotante inicial se almacenan en los índices pares. Los índices de punto flotante final se almacenan en los índices impares. El primer par de índices representa la primera intersección.

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

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_OUTOFMEMORY	No se puede asignar el objeto auxiliar del controlador stroke.
E_UNEXPECTED	Tipo de propiedad o parámetro inesperado.
E_INK_EXCEPTION	Se produjo una excepción dentro del método .

Comentarios

Este método devuelve una matriz que indica dónde el trazo interseca el rectángulo especificado. Cada segmento del trazo que interseca el rectángulo es un par de índices, alternando con un índice inicial seguido de un índice final.

Si el trazo comienza dentro del rectángulo de prueba, el primer índice se establece en -1. Si el trazo finaliza dentro del rectángulo de prueba, el último índice se establece en -1. Si el trazo está totalmente fuera del rectángulo de prueba, se devuelve una matriz vacía. Por ejemplo, si un trazo comienza dentro del rectángulo de prueba, deja los límites del rectángulo, vuelve dentro y sale de nuevo, el método GetRectangleIntersections podría devolver {-1, 1.4, 5.5, 10.1} para describir los dos segmentos del trazo que se encuentran dentro del rectángulo.

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

Clip (método)

FindIntersections (método)

IInkStrokeDisp (Interfaz)