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 [僅限傳統型應用程式]
最低支援的伺服器	都不支援
標頭	IACom.h (也需要 IACom_i.c)
DLL	IACom.dll

另請參閱

IInkAnalyzer

ICoNtextNode：：AddPropertyData

IInkAnalyzer：:D eleteAnalysisHint 方法

IInkAnalyzer：：GetAnalysisHints 方法

IInkAnalyzer：：GetAnalysisHintsByName 方法

分析提示屬性

筆跡分析參考