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::SetStrokesIInkAnalyzer::SetStrokesTypeIInkAnalyzer::SetStrokeType如果已確認ICoNtextNode物件,則會傳回CORE_E_INVALIDOPERATION。

如果確認來源或目的地節點,ICoNtextNode::ReparentStrokeByIdToNode會傳回錯誤。

規格需求

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

另請參閱

ICoNtextNode

ICoNtextNode::IsConfirmed

筆跡分析參考