Metodo IInkStrokeDisp::GetRectangleIntersections (msinkaut.h)

Articolo
03/05/2024

Trova i punti in cui un oggetto IInkStrokeDisp interseca un determinato rettangolo.

Sintassi

HRESULT GetRectangleIntersections(
  [in]          IInkRectangle *Rectangle,
  [out, retval] VARIANT       *Intersections
);

Parametri

[in] Rectangle

Il rettangolo in coordinate dello spazio penna , che descrive l'area di hit test.

[out, retval] Intersections

Quando questo metodo restituisce, contiene una matrice VARIANT che indica dove il tratto interseca il rettangolo. Gli indici a virgola mobile iniziale vengono archiviati negli indici anche. Gli indici a virgola mobile finali vengono archiviati negli indici dispari. La prima coppia di indici rappresenta la prima intersezione.

Per altre informazioni sulla struttura VARIANT, vedere Uso della libreria COM.

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_OUTOFMEMORY	Impossibile allocare l'oggetto helper del gestore del tratto.
E_UNEXPECTED	Parametro o tipo di proprietà imprevisto.
E_INK_EXCEPTION	Si è verificata un'eccezione all'interno del metodo.

Commenti

Questo metodo restituisce una matrice che indica dove il tratto interseca il rettangolo specificato. Ogni segmento del tratto che interseca il rettangolo è una coppia di indici, alternando un indice iniziale seguito da un indice finale.

Se il tratto inizia all'interno del rettangolo di test, il primo indice è impostato su -1. Se il tratto termina all'interno del rettangolo di test, l'ultimo indice è impostato su -1. Se il tratto è completamente esterno al rettangolo di test, viene restituita una matrice vuota. Ad esempio, se un tratto inizia all'interno del rettangolo di test, lascia i limiti del rettangolo, restituisce di nuovo all'interno e lascia di nuovo il metodo GetRectangleIntersections potrebbe restituire {-1, 1.4, 5.5, 10.1} per descrivere i due segmenti del tratto che rientrano nel rettangolo.

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 Clip

FindIntersections, metodo

Interfaccia IInkStrokeDisp

Condividi tramite