ICoNtextNode::Confirm 方法
修改確認類型,控制 IInkAnalyzer 物件可以變更 ICoNtextNode的內容。
語法
HRESULT Confirm(
[in] ConfirmationType confirmedType
);
參數
-
confirmedType [in]
-
套用至節點的 ConfirmationType 。
傳回值
如需傳回值的描述,請參閱 類別和介面 - 筆跡分析。
備註
使用此方法可讓使用者確認 IInkAnalyzer 已正確分析筆劃。 呼叫 ICoNtextNode::Confirm之後,IInkAnalyzer將不會在稍後分析期間變更這些筆劃的ICoNtextNode物件。
當使用者確認分析結果,且不希望IInkAnalyzer在稍後的分析期間變更ICoNtextNode,請使用ICoNtextNode::Confirm。 例如,如果使用者寫入 「to」 一詞,然後應用程式呼叫 IInkAnalyzer::Analyze 方法,則筆跡分析器會產生具有 「to」 值的 InkWord 節點。 如果使用者接著在 「to」 後面新增 「me」作為單字,且應用程式再次呼叫 IInkAnalyzer::Analyze 方法 ,則筆跡分析器可能會移除先前的 InkWord 節點,並使用 「tome」 值建立新的 InkWord 節點。 不過,如果在第一次呼叫IInkAnalyzer::Analyze 方法之後,應用程式會在 InkWord 節點上呼叫ICoNtextNode::Confirm,使用ConfirmType 值 NodeTypeAndProperties在使用者新增 「me」 之前,在應用程式呼叫IInkAnalyzer::Analyze 方法時,筆跡分析器不會移除或變更 「to」 節點。 相反地,筆跡分析器可以辨識兩個 「to」 和 「me」 的 InkWord 節點。
ICoNtextNode 只能確認 InkWord 和 InkDrawing 類型的物件 (請參閱 內容節點類型) 。 當節點不是分葉節點時,ICoNtextNode::Confirm會傳回E_INVALIDARG。
IInkAnalyzer::RemoveStroke 方法 與 IInkAnalyzer::RemoveStrokes 方法 會取消確認從中移除筆劃資料的任何節點。
ICoNtextNode::SetStrokes、IInkAnalyzer::SetStrokesType和IInkAnalyzer::SetStrokeType如果已確認ICoNtextNode物件,則會傳回CORE_E_INVALIDOPERATION。
如果確認來源或目的地節點,ICoNtextNode::ReparentStrokeByIdToNode會傳回錯誤。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows XP Tablet PC Edition [僅限傳統型應用程式] |
最低支援的伺服器 |
都不支援 |
標頭 |
|
DLL |
|