IContextNode::ReparentStrokeByIdToNode メソッド

  • [アーティクル]

この IContextNode から指定した IContextNode にストローク データを移動 します。

構文

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

パラメーター

lStrokeId [in]

移動するストロークの識別子。

pContextNodeDestination [in]

ストローク データの移動先の IContextNode オブジェクト。

戻り値

戻り値の説明については、「 クラスとインターフェイス - インク分析」を参照してください。

解説

指定した IContextNode オブジェクトは、 Context Node Types クラスの定数 InkWord、 InkDrawing、 InkBullet、 UnclassifiedInk のいずれかである必要があります。 ストロークを他の種類の IContextNode オブジェクトに移動しようとすると、戻り値 E_INVALIDARG。

このメソッドは、インク以外のリーフ IContextNode オブジェクトを含む任意の IContextNode オブジェクトから呼び出すことができます。 指定したストロークは、この IContextNode オブジェクトの子孫のいずれかによって参照されるか 、E_INVALIDARG が返される必要があります。

この IContextNode または pContextNodeDestination の IContextNode のいずれかが確認された場合は、E_INVALIDARGが返されます (「IContextNode::IsConfirmed」を参照してください)。

インク アナライザーは、このメソッドに応答して、結果ツリーから空のコンテキスト ノードを削除しません。

  • ストローク データを参照しないインク リーフ ノードは空のノードです。
  • 子ノードを参照しないコンテナー ノードは空のノードです。

空のノードは、インク分析操作中にツリー内にある場合にエラーを生成します。 インク アナライザーのツリーからノードを削除するには、親ノードの IContextNode::D eleteSubNode メソッドを呼び出します ( 「IContextNode::GetParentNode」を参照)。

必要条件

要件 値
サポートされている最小のクライアント
 Windows XP タブレット PC エディション [デスクトップ アプリのみ]
サポートされている最小のサーバー
 サポートなし
Header
IACom.h (IACom_i.c も必要)
[DLL]
IACom.dll

関連項目

IContextNode

IContextNode::SetStrokes

インク分析リファレンス