共用方式為


IInkAnalyzer::AddStroke 方法

將單一筆劃的筆劃資料新增至 IInkAnalyzer ,並將使用中輸入執行緒的文化特性識別碼指派給筆劃。

語法

HRESULT AddStroke(
  [in]  LONG         lStrokeId,
  [in]  ULONG        ulStrokePacketDataCount,
  [in]  LONG         *plStrokePacketData,
  [in]  ULONG        ulStrokePacketDescriptionCount,
  [in]  GUID         *pStrokePacketDescriptionGuids,
  [out] IContextNode **ppContextNodeStrokeAddedTo
);

參數

lStrokeId [in]

要加入之筆劃的識別碼。

ulStrokePacketDataCount [in]

筆劃中的封包數目。

plStrokePacketData [in]

陣列,包含筆劃的封包資料。

ulStrokePacketDescriptionCount [in]

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

pStrokePacketDescriptionGuids [in]

包含封包屬性識別碼的陣列。

ppCoNtextNodeStrokeAddedTo [out]

IInkAnalyzer新增筆劃的ICoNtextNode指標。

傳回值

如需傳回值的描述,請參閱 類別和介面 - 筆跡分析

備註

警告

若要避免記憶體流失,當您不再需要使用 物件時,請在ppCoNtextNodeStrokeAddedTo上呼叫IUnknown::Release

ppCoNtextNodeStrokeAddedToNull時,表示呼叫端對方法的傳回值不感興趣。

IInkAnalyzer會將筆劃新增至 UnclassifiedInk 類型的ICoNtextNode (請參閱內容節點類型) 。 此節點位於根節點的子節點集合中, (請參閱 IInkAnalyzer::GetRootNode 方法和ICoNtextNode::GetSubNodes 方法) 。

IInkAnalyzer會將使用中輸入執行緒的文化特性識別碼指派給筆劃,並將筆劃新增至筆跡分析器根節點下第一個 UnclassifiedInk 內容節點,其中包含具有相同文化特性識別碼的筆劃。 如果筆跡分析器沒有具有相同文化特性識別碼的節點,它會在其根節點下建立新的 UnclassifiedInk 內容節點,並將筆劃新增至新的 UnclassifiedInk 內容節點。

plStrokePacketData 包含筆劃中所有點的封包資料。 pStrokePacketDescriptionGuids 包含全域唯一識別碼 (GUID) ,描述筆劃中每個點所包含的封包資料類型。 如需可用封包屬性的完整清單,請參閱 PacketPropertyGuids 常數

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

如果IInkAnalyzer已經包含具有相同筆劃識別碼的筆劃,IInkAnalyzer會傳回E_INVALIDARGHRESULT

規格需求

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

另請參閱

InkAnalyzer

IInkAnalyzer::AddStrokeForLanguage 方法

IInkAnalyzer::AddStrokes 方法

IInkAnalyzer::AddStrokesForLanguage 方法

IInkAnalyzer::RemoveStroke 方法

IInkAnalyzer::RemoveStrokes 方法

筆跡分析參考