Condividi tramite


Metodo IInkStrokeDisp::Clip (msinkaut.h)

Rimuove parti di un oggetto IInkStrokeDisp o di un insieme InkStrokes che si trovano all'esterno di un rettangolo.

Sintassi

HRESULT Clip(
  [in] IInkRectangle *Rectangle
);

Parametri

[in] Rectangle

Specifica il rettangolo esterno al quale viene ritagliato il tratto o i tratti. Il rettangolo viene specificato nelle coordinate dello spazio 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.
REGDB_CLASSNOTREG
L'oggetto InkDisp non è registrato.
E_INVALIDARG
Rettangolo clip non valido.
E_INK_EXCEPTION
Si è verificata un'eccezione all'interno del metodo.
E_FAIL
Si è verificato un errore non specificato.

Commenti

Per un oggetto InkDisp , tutti i tratti intersecati dal rettangolo vengono suddivisi nei punti di intersezione. Tutte le parti dei tratti all'esterno del rettangolo vengono rimosse dall'oggetto InkDisp . Il metodo può aggiungere nuovi punti a un tratto nel punto in cui il tratto interseca il rettangolo. Dopo aver chiamato il metodo Clip in un oggetto InkDisp , gli ID dei tratti dell'insieme tratti dell'oggetto InkDisp sono garantiti univoci, ma non sono garantiti per mantenere altre informazioni.

Questo metodo non tiene conto della larghezza della penna durante il ritaglio. Clip solo i dati effettivi dell'input penna o del tratto.

Per un oggetto IInkStrokeDisp o un insieme InkStrokes , il metodo Clip aggiorna l'oggetto InkDisp padre. Ogni volta che l'input penna viene rimosso da un oggetto InkDisp , gli oggetti IInkStrokeDisp o le raccolte InkStrokes definite per tale oggetto InkDisp possono essere invalidate.

Per altre informazioni sui dati dell'input penna, vedere Dati input penna.

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 HitTest(Rectangle, Single)

Interfaccia IInkStrokeDisp

Classe InkRectangle