IInkAnalyzer::AddStrokesForLanguage メソッド

  • [アーティクル]

複数のストロークのストローク データを IInkAnalyzer に 追加し、指定したカルチャ識別子をストロークに割り当てます。

構文

HRESULT AddStrokesForLanguage(
  [in]  ULONG        ulStrokeIdsCount,
  [in]  LONG         *plIdofStrokesToAdd,
  [in]  LONG         lStrokesLCID,
  [in]  ULONG        ulStrokePacketDescriptionCount,
  [in]  GUID         *pStrokePacketDescriptionGuids,
  [in]  ULONG        *pulPacketDataCountPerStroke,
  [in]  LONG         *plStrokePacketData,
  [out] IContextNode **ppContextNodeStrokeAddedTo
);

パラメーター

ulStrokeIdsCount [in]

追加するストロークの数。

plIdofStrokesToAdd [in]

ストローク識別子を含む配列。

lStrokesLCID [in]

ストロークに割り当てるカルチャ識別子を表す値。

ulStrokePacketDescriptionCount [in]

各パケットのプロパティの数。

pStrokePacketDescriptionGuids [in]

パケット プロパティ識別子を含む配列。

pulPacketDataCountPerStroke [in]

各ストロークのパケット数を含む配列。

plStrokePacketData [in]

ストロークのパケット データを含む配列。

ppContextNodeStrokeAddedTo [out]

インク アナライザーがストロークを追加した IContextNode 。

戻り値

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

解説

注意事項

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

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

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

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

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

注意

IInkAnalyzer::AddStrokes メソッドの 1 回の呼び出しでは、同じパケット記述を持つストロークのみを追加できます。

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

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

必要条件

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

関連項目

IInkAnalyzer

IInkAnalyzer::AddStroke メソッド

IInkAnalyzer::AddStrokeForLanguage メソッド

IInkAnalyzer::AddStrokes メソッド

IInkAnalyzer::RemoveStroke メソッド

IInkAnalyzer::RemoveStrokes メソッド

インク分析リファレンス