IContextNode::ReparentStrokeByIdToNode-Methode

Verschiebt Strichdaten von diesem IContextNode in den angegebenen IContextNode.

Syntax

HRESULT ReparentStrokeByIdToNode(
  [in] LONG         lStrokeId,
  [in] IContextNode *pContextNodeDestination
);

Parameter

lStrokeId [in]

Der Bezeichner des zu verschiebenden Strichs.

pContextNodeDestination [in]

Das IContextNode-Objekt , in das die Strichdaten verschoben werden sollen.

Rückgabewert

Eine Beschreibung der Rückgabewerte finden Sie unter Klassen und Schnittstellen – Freihandanalyse.

Bemerkungen

Das angegebene IContextNode-Objekt muss einer der folgenden Typen aus den Context Node Types-Konstanten sein: InkWord, InkDrawing, InkBullet oder UnclassifiedInk. Der Versuch, einen Strich auf einen anderen Typ von IContextNode-Objekt zu verschieben, führt zu einem Rückgabewert von E_INVALIDARG.

Diese Methode kann von jedem IContextNode-Objekt aufgerufen werden, einschließlich von IContextNode-Objekten ohne Freihandblatt. Auf den angegebenen Strich muss von einem der nachfolgern dieses IContextNode-Objekts verwiesen werden, oder E_INVALIDARG zurückgegeben wird.

Wenn entweder dieser IContextNode oder der IContextNode in pContextNodeDestination bestätigt wird, wird E_INVALIDARG zurückgegeben (siehe IContextNode::IsConfirmed).

Der Freihandanalysator löscht als Reaktion auf diese Methode keine leeren Kontextknoten aus seiner Ergebnisstruktur.

• Ein Freihandblattknoten, der keine Strichdaten referenziert, ist ein leerer Knoten.
• Ein Containerknoten, der nicht auf untergeordnete Knoten verweist, ist ein leerer Knoten.

Ein leerer Knoten generiert Fehler, wenn er sich während eines Freihandanalysevorgangs in der Struktur befindet. Um einen Knoten aus der Struktur der Freihandanalyse zu entfernen, rufen Sie die IContextNode::D eleteSubNode-Methode des übergeordneten Knotens auf (siehe IContextNode::GetParentNode).

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Header	IACom.h (erfordert auch IACom_i.c)
DLL	IACom.dll

Siehe auch

IContextNode

IContextNode::SetStrokes

Freihandanalysereferenz