Metodo IInkDisp::HitTestCircle (msinkaut.h)

  • Articolo

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