IContextNode::ReparentStrokeByIdToNode-Methode
Verschiebt Strichdaten aus 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 – Ink-Analyse.
Bemerkungen
Das angegebene IContextNode-Objekt muss einer der folgenden Typen aus den Konstanten für Kontextknotentypen sein: InkWord, InkDrawing, InkBullet oder UnclassifiedInk. Der Versuch, einen Strich in einen anderen IContextNode-Objekttyp zu verschieben, führt zu einem Rückgabewert von E _ INVALIDARG.
Diese Methode kann von jedem IContextNode-Objekt aufgerufen werden, einschließlich IContextNode-Objekten ohne Ink-Blatt. Auf den angegebenen Strich muss von einem der Nachfolger dieses IContextNode-Objekts verwiesen werden, oder E _ INVALIDARG wird zurückgegeben.
Wenn entweder dieser IContextNode oder der IContextNode in pContextNodeDestination bestätigt wird, wird E _ INVALIDARG zurückgegeben (siehe IContextNode::IsConfirmed).
Das Freihandanalyseprogramm löscht keine leeren Kontextknoten aus der Ergebnisstruktur als Reaktion auf diese Methode.
- Ein Freihandblattknoten, der auf keine Strichdaten verweist, 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 des Freihandanalysetools zu entfernen, rufen Sie die IContextNode::D eleteSubNode-Methode des übergeordneten Knotens auf (siehe IContextNode::GetParentNode).
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Nur Desktop-Apps der XP Tablet PC Edition [] |
| Unterstützte Mindestversion (Server) |
Nicht unterstützt |
| Header |
|
| DLL |
|