Share via


IInkDisp::ExtractStrokes-Methode (msinkaut.h)

Gibt die Striche an, die aus einer InkDisp-Klasse extrahiert und in eine neue InkDisp-Klasse ausgeschnitten oder in eine neue InkDisp-Klasse kopiert werden sollen, indem die bekannte Auflistung von Strichen verwendet wird, um zu bestimmen, welche Striche extrahiert werden sollen.

Syntax

HRESULT ExtractStrokes(
  [in, optional] IInkStrokes     *Strokes,
  [in, optional] InkExtractFlags ExtractFlags,
  [out, retval]  IInkDisp        **ExtractedInk
);

Parameter

[in, optional] Strokes

Optional. Gibt die Sammlung der zu extrahierenden Striche an. Der Standardwert ist 0, der angibt, dass alle Striche extrahiert werden.

[in, optional] ExtractFlags

Optional. Gibt den InkExtractFlags-Enumerationstyp an, der angibt, ob die Freihandeingabe ausgeschnitten oder in das neue Freihandobjekt kopiert wird. Der Standardwert ist IEF_DEFAULT, wodurch die Striche gekürzt werden.

[out, retval] ExtractedInk

Wenn diese Methode zurückgibt, enthält einen Zeiger auf ein neues InkDisp Class-Objekt , das die extrahierte Auflistung von ausgeschnittenen oder kopierten 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_MISMATCHED_INK_OBJECT
Das InkDisp Class-Objekt der InkStrokes-Auflistung muss mit der bekannten InkDisp-Klasse übereinstimmen.
E_INK_EXCEPTION
Innerhalb der -Methode ist eine Ausnahme aufgetreten.
E_INK_SOME_STROKES_NOT_EXTRACTED
Nicht alle Striche wurden extrahiert.
E_OUTOFMEMORY
Speicher, der zum Ausführen des Vorgangs verwendet wird, kann nicht zugeordnet werden.
E_INVALIDARG
Ungültige Extraktionsflags.
REGDB_CLASSNOTREG
Die InkDisp Class-Objektklasse ist nicht registriert.

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

Weitere Informationen

ExtractWithRectangle-Methode

IInkDisp

InkDisp-Klasse