Metodo IInkDisp::HitTestWithLasso (msinkaut.h)

Articolo
03/05/2024

Recupera i tratti all'interno di un'area di selezione polilinea.

Sintassi

HRESULT HitTestWithLasso(
  [in]                VARIANT     Points,
  [in]                float       IntersectPercent,
  [in, out, optional] VARIANT     *LassoPoints,
  [out, retval]       IInkStrokes **Strokes
);

Parametri

[in] Points

Punti utilizzati nello strumento di selezione per selezionare i tratti. L'area di selezione è l'area all'interno del limite di selezione in cui il limite interseca per primo. Se il limite non si interseca, il metodo aggiunge un punto alla fine della matrice per creare una linea retta dal primo punto all'ultimo punto. Se il limite è una linea retta (nessuna area all'interno del limite di selezione), non viene selezionato alcun tratto.

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

[in] IntersectPercent

Percentuale di punti del tratto che devono essere contenuti nello strumento di selezione per includere il tratto nella raccolta risultante di tratti. Se zero (0), tutti i tratti contenuti all'interno o intersecati dallo strumento di selezione vengono inclusi nella raccolta risultante di tratti. Se 100, nella raccolta sono inclusi solo tratti completamente contenuti nello strumento di selezione. I tratti che intersecano lo strumento di selezione vengono inclusi nella raccolta se la percentuale di punti in tali tratti contenuti nello strumento di selezione è maggiore o uguale alla percentuale percentIntersect . Le percentuali frazionarie vengono arrotondate per errotondamento.

[in, out, optional] LassoPoints

facoltativo. Recupera la parte specifica dello strumento di selezione utilizzata per la selezione. Poiché un utente può disegnare molti tipi diversi di strumenti di selezione, alcuni dei quali si sovrappongono più volte, può essere utile per illustrare quale parte dello strumento di selezione è stata usata per la selezione. Il valore predefinito è un puntatore NULL , il che significa che non vengono restituite informazioni.

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

[out, retval] Strokes

Quando termina, questo metodo contiene un puntatore alla raccolta di tratti che costituiscono l'input penna.

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_OUTOFMEMORY	Impossibile allocare l'operazione di memoria.

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

Insieme InkStrokes

Condividi tramite