Metodo IInkStrokeDisp::NearestPoint (msinkaut.h)

Articolo
03/09/2024

Trova la posizione sul tratto più vicino a un punto noto e restituisce la distanza che il punto proviene dal tratto. Tutto è in coordinate di spazio input penna.

Sintassi

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

Parametri

[in] X

Posizione x nello spazio input penna del punto da testare.

[in] Y

Posizione y nello spazio input penna del punto da testare.

[in, out, optional] Distance

facoltativo. Distanza dal punto al tratto. Questo parametro può essere NULL. Il valore predefinito è 0.

[out, retval] Point

Quando termina, questo metodo contiene il valore di indice a virgola mobile che rappresenta la posizione più vicina del tratto.

Un indice a virgola mobile è un valore float che rappresenta una posizione tra due punti nel tratto. Ad esempio, se 0,0 è il primo punto del tratto e 1,0 è il secondo punto del tratto, 0,5 è a metà tra il primo e il secondo punto. Analogamente, un valore di indice a virgola mobile pari a 37,25 rappresenta una posizione del 25% lungo la linea tra i punti 37 e 38 del tratto.

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 .

Commenti

Il parametro distance 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

Requisito	Valore
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

Vedi anche

Metodo GetRectangleIntersections

Metodo HitTest(Point, Single)

Interfaccia IInkStrokeDisp

Metodo NearestPoint [classe InkDisp]

Condividi tramite