Metodo IInkDisp::NearestPoint (msinkaut.h)

Articolo
08/24/2023

Recupera L'oggetto IInkStrokeDisp all'interno dell'oggetto InkDisp più vicino a un punto noto, fornendo facoltativamente l'indice del punto più vicino e la distanza del tratto dal punto specificato.

Sintassi

HRESULT NearestPoint(
  [in]                long           X,
  [in]                long           Y,
  [in, out, optional] float          *PointOnStroke,
  [in, out, optional] float          *DistanceFromPacket,
  [out, retval]       IInkStrokeDisp **Stroke
);

Parametri

[in] X

Posizione x- nello spazio input penna del punto.

[in] Y

Specifica la y- posizione nello spazio input penna del punto.

[in, out, optional] PointOnStroke

Facoltativa. Recupera il punto sulla linea del tratto più vicino al punto specificato all'interno dell'oggetto InkDisp . Ad esempio, un valore pari a 1,5 indica che il punto cade a metà tra il primo e il secondo pacchetto del tratto. Questo parametro può essere NULL. Il valore predefinito è 0.

[in, out, optional] DistanceFromPacket

Facoltativa. Recupera la distanza tra il punto specificato nello spazio input penna e il tratto più vicino nell'oggetto InkDisp . Questo parametro può essere NULL. il valore predefinito è 0.

[out, retval] Stroke

Quando termina, questo metodo contiene IInkStrokeDisp che contiene un punto più vicino al punto specificato nell'oggetto InkDisp . Se più tratti contengono un punto che corrisponde alla stessa distanza dal punto specificato, il valore di questo risultato è arbitrario.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_POINTER	Un parametro contiene un puntatore non valido.
E_FAIL	Si è verificato un errore non specificato.
E_INK_EXCEPTION	Si è verificata un'eccezione all'interno del metodo .
E_OUTOFMEMORY	Impossibile allocare l'operazione di memoria.

Commenti

Il parametro del punto di output è definito come numero a virgola mobile perché il punto sulla linea del tratto può essere compreso tra due punti di coordinate fisiche. Utilizzare questo valore per dividere il tratto con il metodo Split oppure arrotondare il valore verso l'alto o verso il basso per indicizzare un pacchetto nel tratto.

Il parametro distanceFromPacket descrive la distanza dal punto alla busta del tratto. Si tratta della distanza tra i due punti meno la metà della larghezza del tratto.

Requisiti


Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	msinkaut.h
Libreria	InkObj.dll