Metodo IInkDisp::ExtractWithRectangle (msinkaut.h)

Articolo
03/05/2024

Taglia o copia tratti da un oggetto InkDisp esistente e li incolla in un nuovo oggetto InkDisp , usando il rettangolo noto per determinare quali tratti estrarre.

Sintassi

HRESULT ExtractWithRectangle(
  [in]           IInkRectangle   *Rectangle,
  [in, optional] InkExtractFlags extractFlags,
  [out, retval]  IInkDisp        **ExtractedInk
);

Parametri

[in] Rectangle

Specifica l'oggetto InkRectangle che delimita l'input penna da estrarre dall'oggetto InkDisp .

[in, optional] extractFlags

facoltativo. Specifica il tipo di enumerazione InkExtractFlags , che determina se l'input penna deve essere tagliato o copiato dall'oggetto InkDisp esistente. Il valore predefinito è IEF_DEFAULT, che taglia i tratti dall'oggetto InkDisp esistente.

[out, retval] ExtractedInk

Quando termina, questo metodo contiene un puntatore a un oggetto InkDisp che contiene la raccolta estratta di tratti.

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_INK_SOME_STROKES_NOT_EXTRACTED	Non tutti i tratti sono stati estratti.
E_OUTOFMEMORY	Impossibile allocare memoria per completare l'operazione.
E_INVALIDARG	Flag di estrazione non validi.
REGDB_CLASSNOTREG	L'oggetto Ink non è stato registrato.

Commenti

Il nuovo oggetto InkDisp mantiene gli attributi, le proprietà e le coordinate del disegno dell'oggetto InkDisp originale.

Questo metodo è utile per creare un nuovo oggetto InkDisp senza i tratti eliminati o tagliati dall'oggetto originale.

Per estrarre tratti da una raccolta nota di tratti, chiamare il metodo ExtractStrokes.

Solo la parte di un tratto all'interno del rettangolo viene aggiunta al nuovo oggetto InkDisp .

Quando il parametro extractFlags è RemoveFromOriginal o Default, tutti i tratti che attraversano il rettangolo vengono divisi e la parte all'interno del rettangolo rimossa dall'oggetto InkDisp esistente.

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