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 方法的單一呼叫中新增。

這個方法會將中途區域展開為區域目前值的聯集，以及新增筆劃的周框方塊。

如果IInkAnalyzer已經包含與其中一個要新增之筆劃相同的識別碼的筆劃，IInkAnalyzer會傳回E_INVALIDARG的HRESULT。

規格需求

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

另請參閱

IInkAnalyzer

IInkAnalyzer：：AddStroke 方法

IInkAnalyzer：：AddStrokeForLanguage 方法

IInkAnalyzer：：AddStrokes 方法

IInkAnalyzer：：RemoveStroke 方法

IInkAnalyzer：：RemoveStrokes 方法

筆跡分析參考