Metodo IInkDisp::HitTestCircle (msinkaut.h)

Articolo
02/29/2024

Recupera l'insieme InkStrokes completamente all'interno o intersecato da un cerchio noto.

Sintassi

HRESULT HitTestCircle(
  [in]          long        X,
  [in]          long        Y,
  [in]          float       radius,
  [out, retval] IInkStrokes **Strokes
);

Parametri

[in] X

Posizione x del centro del cerchio di hit test in unità spazio penna.

[in] Y

Posizione y del centro del cerchio di hit test in unità spaziali penna.

[in] radius

Raggio del cerchio da usare nell'hit test, in unità spazio penna.

[out, retval] Strokes

Quando questo metodo restituisce, contiene la raccolta di tratti completamente all'interno o intersecati dal cerchio specificato.

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_INK_EXCEPTION	Si è verificata un'eccezione all'interno del metodo.
E_INVALIDARG	Handle di visualizzazione non valido.
E_UNEXPECTED	Parametro o tipo di proprietà imprevisto.

Commenti

Se un tratto interseca il cerchio, viene restituito il tratto completo.

Il metodo calcola l'intersezione, considerando il set completo di attributi di disegno che si applicano al tratto, inclusa la larghezza completa della penna, l'smoothing bezier (se presente) e la forma della punta della penna.

Dopo aver eseguito una rotazione o una trasformazione shear su un tratto o una raccolta di tratti, le coordinate e trasformate x-y- non sono più incentrate sulle coordinate originali. A causa di questo, l'argomento radius non deve essere calcolato dalle x- coordinate o y- .

Per determinare quali punti di un tratto noto intersecano l'area di test, chiamare il metodo HitTest dell'oggetto IInkStrokeDisp .

L'applicazione deve sempre passare un puntatore di destinazione per la raccolta risultante di tratti. Se non sono presenti intersezioni, la raccolta ha un numero pari a zero.

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 HitTest(Point[], Single)

Metodo HitTest(Rectangle, Single)

IInkDisp

Classe InkDisp

Raccolta InkStrokes

Condividi tramite