IInkAnalyzer::AddStrokesToCustomRecognizer メソッド
複数のストロークのストローク データをカスタム認識エンジン ノードに追加します。
構文
HRESULT AddStrokesToCustomRecognizer(
[in] ULONG ulStrokeIdsCount,
[in] LONG *plStrokeIds,
[in] ULONG ulStrokePacketDescriptionCount,
[in] GUID *pStrokePacketDescriptionGuids,
[in] ULONG *pulPacketDataCountPerStroke,
[in] LONG *plStrokePacketData,
[in] IContextNode *pCustomRecognizer,
[out] IContextNode **ppContextNodeStrokeAddedTo
);
パラメーター
-
ulStrokeIdsCount [in]
-
追加するストロークの数。
-
plStrokeIds [in]
-
ストローク識別子を含む配列。
-
ulStrokePacketDescriptionCount [in]
-
各パケット内のプロパティの数。
-
pStrokePacketDescriptionGuids [in]
-
パケット プロパティ識別子を含む配列。
-
pulPacketDataCountPerStroke [in]
-
各ストロークのパケット数を含む配列。
-
plStrokePacketData [in]
-
ストロークのパケット データを含む配列。
-
pCustomRecognizer [in]
-
ストロークを追加する CustomRecognizer 型の IContextNode。
-
ppContextNodeStrokeAddedTo [out]
-
インク アナライザーがストロークを追加した IContextNode 。
戻り値
戻り値の説明については、「 クラスとインターフェイス - インク分析」を参照してください。
解説
注意事項
メモリ リークを回避するには、 オブジェクトを使用する必要がなくなったときに、ppContextNodeStrokeAddedTo で IUnknown::Release を呼び出します。
ppContextNodeStrokeAddedTo が NULL の場合、呼び出し元がメソッドからの戻り値に関心を持たないことを示します。
IInkAnalyzer は、ストロークを CustomRecognizer 型の IContextNode に追加します (「コンテキスト ノードの種類」を参照)。 このノードは、ルート ノードのサブノード コレクションにあります ( 「IInkAnalyzer::GetRootNode メソッド 」および 「IContextNode::GetSubNodes メソッド」を参照してください)。
IInkAnalyzer は、アクティブな入力スレッドのカルチャ識別子をストロークに割り当て、CustomRecognizer ノードの下の最初の UnclassifiedInk ノードにストロークを追加します。 UnclassifiedInk ノードが存在しない場合は、作成されます。 CustomRecognizer ノードに関連付けられている IInkAnalysisRecognizer がカルチャ識別子をサポートしていない場合、IInkAnalyzer は分析を続行し、IAnalysisWarning 警告を生成します。 この警告の AnalysisWarningCode 値は AnalysisWarningCode_LanguageIdNotRespected です。
plStrokePacketData には、すべてのストロークのパケット データが含まれています。 pStrokePacketDescriptionGuids には、各ストロークの各ポイントに含まれるパケット データの種類を記述するグローバル一意識別子 (GUID) が含まれています。 使用可能なパケット プロパティの完全な一覧については、「 PacketPropertyGuids 定数」を参照してください。
Note
IInkAnalyzer::AddStrokesToCustomRecognizer メソッドの 1 回の呼び出しでは、同じパケット記述を持つストロークのみを追加できます。
このメソッドは、領域の現在の値と追加されたストロークの境界ボックスの和集合にダーティ領域を展開します。
IInkAnalyzer は、次の状況でE_INVALIDARGの HRESULT を返します。
- IInkAnalyzer には、追加するストロークの 1 つと同じ識別子を持つストロークが既に含まれています。
- pCustomRecognizer パラメーターには、別の IInkAnalyzer オブジェクトに関連付けられているカスタム認識エンジン ノードが含まれています。
- pCustomRecognizer パラメーターには、CustomRecognizer 型ではない IContextNode が含まれています。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows XP タブレット PC エディション [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
サポートなし |
| ヘッダー |
|
| [DLL] |
|