IInkAnalyzer::AddStroke メソッド

[アーティクル]
06/13/2023

1 つのストロークのストロークデータを IInkAnalyzer に 追加し、アクティブな入力スレッドのカルチャ識別子をストロークに割り当てます。

構文

HRESULT AddStroke(
  [in]  LONG         lStrokeId,
  [in]  ULONG        ulStrokePacketDataCount,
  [in]  LONG         *plStrokePacketData,
  [in]  ULONG        ulStrokePacketDescriptionCount,
  [in]  GUID         *pStrokePacketDescriptionGuids,
  [out] IContextNode **ppContextNodeStrokeAddedTo
);

パラメーター

lStrokeId [in]: 追加するストロークの識別子。
ulStrokePacketDataCount [in]: ストローク内のパケットの数。
plStrokePacketData [in]: ストロークのパケットデータを含む配列。
ulStrokePacketDescriptionCount [in]: 各パケットのパケットプロパティの数。
pStrokePacketDescriptionGuids [in]: パケットプロパティ識別子を含む配列。
ppContextNodeStrokeAddedTo [out]: IInkAnalyzer によってストロークが追加された IContextNode へのポインター。

戻り値

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

解説

注意事項

メモリリークを回避するには、オブジェクトを使用する必要がなくなったときに、ppContextNodeStrokeAddedTo で IUnknown::Release を呼び出します。

ppContextNodeStrokeAddedTo が NULL の場合、呼び出し元がメソッドからの戻り値に関心を持たないことを示します。

IInkAnalyzer は、UnclassifiedInk 型の IContextNode にストロークを追加します (「コンテキストノードの種類」を参照)。このノードは、ルートノードのサブノードコレクションにあります ( 「IInkAnalyzer::GetRootNode メソッド 」および 「IContextNode::GetSubNodes メソッド」を参照してください)。

IInkAnalyzer は、アクティブな入力スレッドのカルチャ識別子をストロークに割り当て、同じカルチャ識別子を持つストロークを含むインクアナライザーのルートノードの下にある最初の UnclassifiedInk コンテキストノードにストロークを追加します。インクアナライザーに同じカルチャ識別子を持つノードがない場合は、ルートノードの下に新しい UnclassifiedInk コンテキストノードが作成され、ストロークが新しい UnclassifiedInk コンテキストノードに追加されます。

plStrokePacketData には、ストローク内のすべてのポイントのパケットデータが含まれています。 pStrokePacketDescriptionGuids には、ストローク内の各ポイントに含まれるパケットデータの種類を記述するグローバル一意識別子 (GUID) が含まれています。使用可能なパケットプロパティの完全な一覧については、「 PacketPropertyGuids 定数」を参照してください。

このメソッドは、領域の現在の値と追加されたストロークの境界ボックスの和集合にダーティ領域を展開します。

IInkAnalyzer に同じストローク識別子を持つストロークが既に含まれている場合、IInkAnalyzer は E_INVALIDARG の HRESULT を返します。

必要条件

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

IInkAnalyzer::AddStroke メソッド

構文

パラメーター

戻り値

解説

必要条件

関連項目

フィードバック

フィードバック

その他のリソース