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 常數。
注意
只有具有相同封包描述的筆劃可以在 對 IInkAnalyzer：：AddStrokesToCustomRecognizer 方法的單一呼叫中新增。
這個方法會將中途區域展開為區域目前值的聯集，以及新增筆劃的周框方塊。
IInkAnalyzer會在下列情況下傳回E_INVALIDARG的HRESULT。
- IInkAnalyzer已經包含與要新增其中一個筆劃相同的識別碼的筆劃。
- pCustomRecognizer參數包含與不同IInkAnalyzer物件相關聯的自訂辨識器節點。
- pCustomRecognizer參數包含不是CustomRecognizer類型的ICoNtextNode。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows XP Tablet PC Edition [僅限傳統型應用程式] |
| 最低支援的伺服器 |
都不支援 |
| 標頭 |
|
| DLL |
|