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。
當 ppCoNtextNodeStrokeAddedTo 為 Null時,表示呼叫端對方法的傳回值不感興趣。
IInkAnalyzer會將筆劃新增至 UnclassifiedInk 類型的ICoNtextNode (請參閱內容節點類型) 。 此節點位於根節點的子節點集合中, (請參閱 IInkAnalyzer::GetRootNode 方法和ICoNtextNode::GetSubNodes 方法) 。
IInkAnalyzer會將使用中輸入執行緒的文化特性識別碼指派給筆劃,並將筆劃新增至筆跡分析器根節點下第一個 UnclassifiedInk 內容節點,其中包含具有相同文化特性識別碼的筆劃。 如果筆跡分析器沒有具有相同文化特性識別碼的節點,它會在其根節點下建立新的 UnclassifiedInk 內容節點,並將筆劃新增至新的 UnclassifiedInk 內容節點。
plStrokePacketData 包含筆劃中所有點的封包資料。 pStrokePacketDescriptionGuids 包含全域唯一識別碼 (GUID) ,描述筆劃中每個點所包含的封包資料類型。 如需可用封包屬性的完整清單,請參閱 PacketPropertyGuids 常數。
這個方法會將中途區域展開為區域目前值的聯集,以及新增筆劃的周框方塊。
如果IInkAnalyzer已經包含具有相同筆劃識別碼的筆劃,IInkAnalyzer會傳回E_INVALIDARG的HRESULT。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows XP Tablet PC Edition [僅限傳統型應用程式] |
最低支援的伺服器 |
都不支援 |
標頭 |
|
DLL |
|