IInkAnalyzer::SetStrokesType 方法
變更指定筆劃的類型。
語法
HRESULT SetStrokesType(
[in] ULONG strokeIdCount,
[in] LONG *plStrokes,
[in] StrokeType StrokeType
);
參數
-
strokeIdCount [in]
-
plStrokes中的筆劃識別碼數目。
-
plStrokes [in]
-
陣列,其中包含要指派 StrokeType之筆劃的筆劃識別碼。
-
StrokeType [in]
-
要指派給筆劃的 StrokeType 值。
傳回值
如需傳回值的描述,請參閱 類別和介面 - 筆跡分析。
備註
如果筆劃的類型是 StrokeType 值 StrokeType_Unclassified, IInkAnalyzer 會在筆墨分析期間將筆劃分類。 否則, IInkAnalyzer 會使用筆劃上設定的類型。
IInkAnalyzer不會將筆劃類型值設定為筆跡分析的一部分。 若要指定或變更筆劃類型,請使用 IInkAnalyzer::SetStrokeType 方法 或 IInkAnalyzer::SetStrokesType 方法。
如果筆劃與不是未分類筆跡節點的 ICoNtextNode 相關聯, (請參閱 ICoNtextNode::GetType) ,此方法會將筆劃移至包含相同語言筆劃的未分類筆跡節點。 如果沒有任何這類內容節點存在,這個方法會建立新的未分類筆跡節點,並將筆劃新增至其中。 未分類的筆跡節點是屬於 UnclassifiedInk 類型的 ICoNtextNode 。
如果此方法從不是未分類筆跡 節點的 ICoNtextNode 移動筆劃,這個方法也會將筆劃的周框方塊新增至筆跡分析器的變更區域, (請參閱 IInkAnalyzer::GetDirtyRegion 方法) 。
如果 StrokeType 參數符合筆劃目前的類型,這個方法就不會移動筆劃。
如果 strokeIds 中所識別的筆劃與 IInkAnalyzer沒有關聯,這個方法會忽略識別碼。
如果沒有指定的筆劃識別與 IInkAnalyzer相關聯的筆劃,這個方法會傳回而不更新 IInkAnalyzer。
在與已確認 NodeTypeAndProperties 的 CoNtextNode 相關聯的筆劃上設定筆劃類型將會引發 InvalidOperationException。
當 plStrokes 為 Null時,這個方法會傳回錯誤碼。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows XP Tablet PC Edition [僅限傳統型應用程式] |
最低支援的伺服器 |
都不支援 |
標頭 |
|
DLL |
|