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 [僅限傳統型應用程式]
最低支援的伺服器	都不支援
標頭	IACom.h (也需要 IACom_i.c)
DLL	IACom.dll

另請參閱

IInkAnalyzer

內容節點類型

IInkAnalyzer：：AddStrokeToCustomRecognizer 方法

IInkAnalyzer：：CreateCustomRecognizer 方法

筆跡分析參考