Método IInkDisp::NearestPoint (msinkaut.h)
Recupera el IInkStrokeDisp dentro del objeto InkDisp más cercano a un punto conocido, proporcionando opcionalmente el índice del punto más cercano y la distancia al trazo desde el punto especificado.
Sintaxis
HRESULT NearestPoint(
[in] long X,
[in] long Y,
[in, out, optional] float *PointOnStroke,
[in, out, optional] float *DistanceFromPacket,
[out, retval] IInkStrokeDisp **Stroke
);
Parámetros
[in] X
Posición x- en el espacio de entrada de lápiz del punto.
[in] Y
Especifica la posición en el y- espacio de entrada de lápiz del punto.
[in, out, optional] PointOnStroke
Opcional. Recupera el punto de la línea del trazo más cercano al punto especificado dentro del objeto InkDisp . Por ejemplo, un valor de 1,5 indica que el punto está a la mitad entre los paquetes primero y segundo del trazo. Este parámetro puede ser NULL. El valor predeterminado es 0.
[in, out, optional] DistanceFromPacket
Opcional. Recupera la distancia entre el punto especificado en el espacio de entrada de lápiz y el trazo más cercano del objeto InkDisp . Este parámetro puede ser NULL. el valor predeterminado es 0.
[out, retval] Stroke
Cuando este método devuelve, contiene el IInkStrokeDisp que contiene un punto más cercano al punto especificado en el objeto InkDisp . Si más de un trazo contiene un punto que es la misma distancia desde el punto especificado, el valor de este resultado es arbitrario.
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 . |
|
No se puede asignar la operación de memoria. |
Comentarios
El parámetro de punto de salida se define como un número de punto flotante porque el punto de la línea del trazo puede estar entre dos puntos de coordenadas físicos. Utilice este valor para dividir el trazo con el método Split o redondear el valor hacia arriba o hacia abajo para indexar un paquete en el trazo.
El parámetro distanceFromPacket 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
| 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 |