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 |
|
| DLL |
|