Compartir a través de

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

  • Artículo

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)