Metodo IInkStrokeDisp::FindIntersections (msinkaut.h)

Articolo
08/25/2023

Recupera i punti in cui questo oggetto IInkStrokeDisp interseca altri oggetti IInkStrokeDisp all'interno di un insieme InkStrokes noto.

Sintassi

HRESULT FindIntersections(
  [in]          IInkStrokes *Strokes,
  [out, retval] VARIANT     *Intersections
);

Parametri

[in] Strokes

Raccolta nota di tratti utilizzati per calcolare i punti in cui questo tratto interseca i tratti nella raccolta. Se NULL, utilizzare tutti i tratti nell'oggetto InkDisp .

Nota La raccolta nota di tratti deve provenire dallo stesso oggetto InkDisp del tratto sottoposto a test per l'intersezione. Se non proviene dallo stesso oggetto InkDisp , E_INK_MISMATCHED_INK_OBJECT viene restituito (vedere "VALORE HRESULT" di seguito). Il metodo FindIntersections è l'unico API (Tablet PC Application Programming Interface) che richiede che la raccolta nota di tratti provengano dallo stesso oggetto InkDisp .

[out, retval] Intersections

Quando termina, questo metodo contiene una matrice di valori di indice a virgola mobile che indicano le posizioni in cui questo tratto interseca i tratti all'interno di una raccolta nota di tratti.

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.

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 un oggetto helper handle IInkStrokeDisp .
E_UNEXPECTED	Parametro o tipo di proprietà imprevisto.
E_INK_EXCEPTION	Si è verificata un'eccezione all'interno del metodo .
E_INK_INCOMPATIBLE_OBJECT	Il parametro strokes non punta a un oggetto InkDisp compatibile.
E_INK_MISMATCHED_INK_OBJECT	L'oggetto InkDisp dell'insieme InkStrokes e questo oggetto IInkStrokeDisp non corrispondono.

Commenti

Questo metodo può determinare solo i punti di intersezione.

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

Vedi anche

Metodo GetRectangleIntersections

Interfaccia IInkStrokeDisp

Insieme InkStrokes

Condividi tramite