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

Busca la ubicación en el trazo más cercano a un punto conocido y devuelve la distancia que ese punto es desde el trazo. Todo está en coordenadas de espacio de entrada de lápiz.

Sintaxis

HRESULT NearestPoint(
  [in]                long  X,
  [in]                long  Y,
  [in, out, optional] float *Distance,
  [out, retval]       float *Point
);

Parámetros

[in] X

Posición x en el espacio de entrada de lápiz del punto que se va a probar.

[in] Y

Posición y en el espacio de entrada de lápiz del punto que se va a probar.

[in, out, optional] Distance

Opcional. Distancia desde el punto hasta el trazo. Este parámetro puede ser NULL. El valor predeterminado es 0.

[out, retval] Point

Cuando este método vuelve, contiene el valor de índice de punto flotante que representa la ubicación más cercana del trazo.

Un índice de punto flotante es un valor flotante que representa una ubicación entre dos puntos del trazo. Como ejemplo, si 0,0 es el primer punto del trazo y 1,0 es el segundo punto del trazo, 0,5 está a la mitad entre los puntos primero y segundo. Del mismo modo, un valor de índice de punto flotante de 37,25 representa una ubicación del 25 por ciento a lo largo de la línea entre los puntos 37 y 38 del trazo.

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_FAIL	Se ha producido un error no especificado.
E_INK_EXCEPTION	Se produjo una excepción dentro del método .

Comentarios

El parámetro distance describe la distancia desde el punto hasta el sobre del trazo. Esta es la distancia entre los dos puntos menos la mitad del ancho del trazo.

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

GetRectangleIntersections (método)

HitTest(Point, Single) (Método)

IInkStrokeDisp (Interfaz)

Método NearestPoint [Clase InkDisp]