IInkDisp::ExtractWithRectangle-Methode (msinkaut.h)

Artikel
03/06/2024

Schneidet oder kopiert Striche aus einem vorhandenen InkDisp-Objekt und fügt sie in ein neues InkDisp-Objekt ein, indem das bekannte Rechteck verwendet wird, um zu bestimmen, welche Striche extrahiert werden sollen.

Syntax

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

Parameter

[in] Rectangle

Gibt das InkRectangle-Objekt an, das die Freihandeingabe trennt, die aus dem InkDisp-Objekt extrahiert werden soll.

[in, optional] extractFlags

Optional. Gibt den InkExtractFlags-Enumerationstyp an, der bestimmt, ob die Freihandeingabe aus dem vorhandenen InkDisp-Objekt ausgeschnitten oder kopiert werden soll. Der Standardwert ist IEF_DEFAULT, der die Striche aus dem vorhandenen InkDisp-Objekt schneidet.

[out, retval] ExtractedInk

Wenn diese Methode zurückgibt, enthält einen Zeiger auf ein InkDisp-Objekt , das die extrahierte Auflistung von Strichen enthält.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_POINTER	Ein Parameter enthielt einen ungültigen Zeiger.
E_INK_EXCEPTION	Innerhalb der -Methode ist eine Ausnahme aufgetreten.
E_INK_SOME_STROKES_NOT_EXTRACTED	Nicht alle Striche wurden extrahiert.
E_OUTOFMEMORY	Speicher kann nicht zugeordnet werden, um den Vorgang abzuschließen.
E_INVALIDARG	Ungültige Extraktionsflags.
REGDB_CLASSNOTREG	Das Freihandobjekt wurde nicht registriert.

Hinweise

Das neue InkDisp-Objekt behält die Zeichnungsattribute, Eigenschaften und Koordinaten des ursprünglichen InkDisp-Objekts bei.

Diese Methode ist nützlich, um ein neues InkDisp-Objekt ohne die gelöschten oder ausgeschnittenen Striche aus dem ursprünglichen Objekt zu erstellen.

Rufen Sie die ExtractStrokes-Methode auf, um Striche aus einer bekannten Sammlung von Strichen zu extrahieren.

Nur der Teil eines Strichs innerhalb des Rechtecks wird dem neuen InkDisp-Objekt hinzugefügt.

Wenn der extractFlags-ParameterRemoveFromOriginal oder Default lautet, werden alle Striche, die das Rechteck überqueren, aufgeteilt, und der Teil innerhalb des Rechtecks wird aus dem vorhandenen InkDisp-Objekt entfernt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	msinkaut.h
Bibliothek	InkObj.dll