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 |
|---|---|
|
Correcto. |
|
Un parámetro contenía un puntero no válido. |
|
Se ha producido un error no especificado. |
|
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)