IInkAnalyzer：：AddStrokeToCustomRecognizer 方法

將單一筆劃的筆劃資料新增至自訂辨識器節點。

語法

HRESULT AddStrokeToCustomRecognizer(
  [in]  ULONG        ulStrokeId,
  [in]  ULONG        ulStrokePacketDataCount,
  [in]  LONG         *plStrokePacketData,
  [in]  ULONG        ulStrokePacketDescriptionCount,
  [in]  GUID         *pStrokePacketDescriptionGuids,
  [in]  IContextNode *pCustomRecognizer,
  [out] IContextNode **ppContextNodeStrokeAddedTo
);

參數

ulStrokeId [in]

要加入之筆劃的識別碼。

ulStrokePacketDataCount [in]

筆劃中的封包數目。

plStrokePacketData [in]

陣列，其中包含筆劃的封包資料。

ulStrokePacketDescriptionCount [in]

每個封包中的封包屬性數目。

pStrokePacketDescriptionGuids [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會在下列情況下傳回E_INVALIDARG的HRESULT。

• IInkAnalyzer已經包含與要新增之筆劃相同的識別碼的筆劃。
• pCustomRecognizer參數包含與不同IInkAnalyzer物件相關聯的自訂辨識器節點。
• pCustomRecognizer參數包含不是CustomRecognizer類型的ICoNtextNode。

規格需求

需求	值
最低支援的用戶端	Windows XP Tablet PC Edition [僅限傳統型應用程式]
最低支援的伺服器	都不支援
標頭	IACom.h (也需要 IACom_i.c)
DLL	IACom.dll

另請參閱

IInkAnalyzer

內容節點類型

IInkAnalyzer：：AddStrokesToCustomRecognizer 方法

IInkAnalyzer：：CreateCustomRecognizer 方法

筆跡分析參考