IInkAnalyzer::CreateAnalysisHint 方法
將具有無限區域的新分析提示節點新增至 IInkAnalyzer。
語法
HRESULT CreateAnalysisHint(
[out] IContextNode **ppAnalysisHint
);
參數
-
ppAnalysisHint [out]
-
新的分析提示節點。
傳回值
如需傳回值的描述,請參閱 類別和介面 - 筆跡分析 。
備註
警告
若要避免記憶體流失,當您不再需要使用 物件時,請在ppAnalysisHint上呼叫IUnknown::Release。
若要提供 IInkAnalyzer的額外內容資訊,您可以將分析提示新增至筆跡分析器。 分析提示可以改善辨識精確度。 例如,您可以為表單應用程式中的欄位新增 factoid 和 guide 資訊。
此方法會使用 AnalysisHint 的內容節點類型建立新的 ICoNtextNode (請參閱ICoNtextNode::GetType) ,並將新的提示新增為IInkAnalyzer物件根節點的子節點, (請參閱ICoNtextNode::GetSubNodes和IInkAnalyzer::GetRootNode 方法) 。
若要將內容資訊新增至提示,請使用 ICoNtextNode::AddPropertyData ,並將 pPropertyDataId 參數設定為其中一個 Analysis Hint Properties 常數。
如果提示被指派無限區域,稱為全域提示, IInkAnalyzer 會將提示的內容套用至不在另一個提示區域內的所有筆跡。 多個提示可以附加至單一 IInkAnalyzer。 不過,只有一個全域提示可以附加至單一筆跡分析器,而且沒有非全域提示可以重迭。 如需提示可以提供之內容資訊類型的詳細資訊,請參閱 分析提示屬性。
新增分析提示不會標示提示的區域以進行重新分析。 若要標示重新分析提示內的區域,請使用 IInkAnalyzer::SetDirtyRegion 方法 ,將中途區域設定為目前中途區域與分析提示區域的聯集。
使用表單應用程式的提示時,應用程式應該避免將文字內容與表單中的筆跡混用。 這表示不應該在分析樹狀結構中建立文字功能變數名稱。 提示旨在將筆跡與頁面上的區域產生關聯;任何文字內容都會干擾此筆跡到提示的關聯。 分析作業可能會合並相同寫入區域中的筆跡和文字內容,以防止筆跡與提示區域產生關聯。
如需筆跡分析的詳細資訊,請參閱 筆跡分析概觀。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows XP Tablet PC Edition [僅限傳統型應用程式] |
最低支援的伺服器 |
都不支援 |
標頭 |
|
DLL |
|