Condividi tramite


Metodo IInkStrokes::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 all'esterno del quale vengono ritagliati i tratti o i tratti. Il rettangolo viene specificato nelle coordinate dello spazio 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.
REGDB_CLASSNOTREG
L'oggetto InkDisp non è registrato.
E_INVALIDARG
Rettangolo di ritaglio 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 su un oggetto InkDisp , gli ID dei tratti nell'insieme tratti dell'oggetto InkDisp sono sicuramente univoci, ma non è garantito mantenere altre informazioni.

Questo metodo non tiene conto della larghezza della penna durante il ritaglio. Ritaglia 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 , tutti gli oggetti IInkStrokeDisp o gli insiemi InkStrokes definiti per tale oggetto InkDisp possono essere invalidati.

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

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

IInkStrokes

Classe InkRectangle

Insieme InkStrokes