IInkAnalyzer 介面

提供配置分析、寫入和繪圖分類，以及手寫辨識的存取權。

成員

IInkAnalyzer介面繼承自IUnknown介面。 IInkAnalyzer 也有下列類型的成員：

• 方法

方法

IInkAnalyzer介面具有這些方法。

方法	Description
中止	取消目前的分析作業。
AddStroke	將單一筆劃的筆劃資料新增至 IInkAnalyzer ，並將使用中輸入執行緒的文化特性識別碼指派給筆劃。
AddStrokeForLanguage	將單一筆劃的筆劃資料新增至 IInkAnalyzer ，並將特定文化特性識別碼指派給筆劃。
AddStrokes	將多個筆劃的筆劃資料新增至 IInkAnalyzer ，並將使用中輸入執行緒的文化特性識別碼指派給筆劃。
AddStrokesForLanguage	將多個筆劃的筆劃資料新增至 IInkAnalyzer ，並將指定的文化特性識別碼指派給筆劃。
AddStrokesToCustomRecognizer	將多個筆劃的筆劃資料加入至自訂辨識器節點。
AddStrokeToCustomRecognizer	將單一筆劃的筆劃資料新增至自訂辨識器節點。
分析	執行同步筆跡分析。
BackgroundAnalyze	執行非同步筆跡分析。
ClearStrokeData	從 IInkAnalyzer清除筆劃封包資料。
CreateAnalysisHint	將具有無限區域的新分析提示節點新增至 IInkAnalyzer。
CreateCoNtextNodes	建立 ICoNtextNodes 物件。
CreateCustomRecognizer	建立 IInkAnalyzer的新自訂辨識器節點。
DeleteAnalysisHint	從 IInkAnalyzer移除分析提示。
FindInkLeafNodes	擷取所有筆跡分葉節點。
FindInkLeafNodesForStrokes	擷取包含指定筆劃的筆跡分葉節點。
FindLeafNodes	擷取所有分葉節點。
FindNode	擷取指定全域唯一識別碼的 ICoNtextNode 物件， (GUID) 。
FindNodesOfType	擷取指定型別的所有 ICoNtextNode 物件。
FindNodesOfTypeForStrokes	擷取包含指定筆劃之指定型別的所有 ICoNtextNode 物件。
FindNodesOfTypeInSubTree	擷取指定型別的所有 ICoNtextNode 物件，這些物件是指定 之 ICoNtextNode 物件的子系。
FindNodesWithCallBack	擷取符合指定準則的所有 ICoNtextNode 物件。
FindNodesWithCallBackInSubTree	擷取符合指定準則的所有 ICoNtextNode 物件，而且是指定 之 ICoNtextNode 物件的子系。
GetAlternates	擷取與 IInkAnalyzer相關聯之所有筆跡的 10 個分析替代專案。
GetAlternatesForCoNtextNodes	擷取指定 之 ICoNtextNodes 集合中節點的分析替代專案。
GetAlternatesForStrokes	擷取具有指定筆劃識別碼之筆劃的分析替代專案。
GetAnalysisHints	擷取附加至IInkAnalyzer的所有分析提示ICoNtextNode物件。
GetAnalysisHintsByName	擷取附加至IInkAnalyzer且具有指定名稱的所有分析提示ICoNtextNode物件。
GetAnalysisModes	擷取旗標，控制 IInkAnalyzer 如何執行筆跡分析。
GetDirtyRegion	擷取自上次分析作業後已變更的區域。
GetInkAnalysisRecognizersByPriority	擷取 IInkAnalysisRecognizer 物件的已排序集合。
GetNodesFromTextRange	擷取與指定內容節點之指定文字範圍相關的 ICoNtextNode 物件集合。
GetRecognizedString	擷取 IInkAnalyzer中整個內容節點樹狀結構之辨識作業的最佳結果字串。
GetRootNode	擷取IInkAnalyzer物件內容樹狀結構的根ICoNtextNode。
GetStrokeLanguageId	擷取指定筆劃的地區設定識別碼。
GetStrokeType	擷取指定之筆劃的類型。
GetTextRangeFromNodes	尋找對應至 ICoNtextNode 物件集合之辨識字串中的文字範圍。
IsAnalyzing	擷取值，指出 IInkAnalyzer 是否正在執行筆跡分析。
LoadResults	將已儲存的分析結果載入 IInkAnalyzer。
ModifyTopAlternate	將目前的最上層替代專案變更為指定的替代專案，並清除與替代專案相關聯的所有 ICoNtextNode 物件的確認類型。
ModifyTopAlternateWithConfirmation	將目前的最上層替代專案變更為指定的 IAnalysisAlternate。
Reconcile	決定在背景筆跡分析期間，分析結果的哪些部分已變更。
RemoveStroke	從 IInkAnalyzer移除指定的筆劃。
RemoveStrokes	從 IInkAnalyzer移除指定的筆劃。
SaveResults	儲存 IInkAnalyzer的所有分析結果。
SaveResultsForNodes	儲存與 IInkAnalyzer相關聯之特定內容節點集合的分析結果。
SaveResultsForStrokes	儲存與 IInkAnalyzer相關聯之指定筆劃的分析結果。
搜尋	提供模糊、不區分大小寫的片語型搜尋，以搜尋分析的書寫筆劃，以及已辨識類型的分析繪圖筆劃。
SearchWithLanguageId	提供模糊、不區分大小寫的片語型搜尋，以搜尋分析的書寫筆劃，以及已辨識類型的分析繪圖筆劃。
SetAnalysisModes	修改旗標，以控制 IInkAnalyzer 執行筆跡分析的方式。
SetDirtyRegion	修改自上次分析作業以來已變更的區域。
SetHighestPriorityInkAnalysisRecognizer	將指定的 IInkAnalysisRecognizer 移至 IInkAnalyzer 物件的筆跡辨識器清單中的第一個位置。
SetStrokeLanguageId	變更指定筆劃的地區設定識別碼。
SetStrokesLanguageId	變更指定筆劃的地區設定識別碼。
SetStrokesType	變更指定筆劃的類型。
SetStrokeType	變更指定筆劃的類型。
UpdateStrokesData	更新指定筆劃的封包資料。

備註

IInkAnalyzer 會使用筆劃封包資料來分析筆跡，而且不會直接與 InkDisp 類別 或 InkStrokes 集合 物件互動。

若要將筆劃新增或移除至 IInkAnalyzer 進行分析，請使用下列其中一種方法。

• IInkAnalyzer：：AddStroke 方法
• IInkAnalyzer：：AddStrokes 方法
• IInkAnalyzer：：RemoveStroke 方法
• IInkAnalyzer：：RemoveStrokes 方法

這些方法會更新變更區域 (請參閱 IInkAnalyzer：：GetDirtyRegion 方法) ，這是下一個分析作業中分析筆劃的區域。

若要分析筆跡，請使用 IInkAnalyzer：：Analyze 方法 或 IInkAnalyzer：：BackgroundAnalyze 方法 。 在分析期間， IInkAnalyzer 會執行配置分析、筆劃分類和手寫辨識。

若要變更版面配置分析和筆劃分類設定，請使用 IInkAnalyzer：：SetAnalysisModes 方法 屬性。

在分析期間， IInkAnalyzer 會收到許多事件，包括背景分析期間產生的事件。 _IAnalysisProxyEvents 支援 IInkAnalyzer的資料 Proxy 功能。 如需詳細資訊，請參閱 使用筆跡分析的資料 Proxy。 若要停止事件處理常式內的分析進程，請呼叫 IInkAnalyzer：：Abort 方法。

若要修改筆跡分析器用來辨識手寫的語言，請使用 IInkAnalyzer：：SetStrokeLanguageId 方法 或 IInkAnalyzer：：SetStrokesLanguageId 方法。 若要修改筆跡分析器如何分類特定筆劃，請使用 IInkAnalyzer：：SetStrokeType 方法 或 IInkAnalyzer：：SetStrokesType 方法。

IInkAnalyzer會載入所有已安裝筆跡辨識器的資訊。 IInkAnalyzer：：GetInkAnalysisRecognizersByPriority 方法會傳回IInkAnalysisRecognizers 集合，其中包含每個可用的 IInkAnalysisRecognizer。 如果有多個筆跡辨識器支援特定語言，請使用 IInkAnalyzer：：SetHighestPriorityInkAnalysisRecognizer 方法 來設定該語言的筆墨辨識器處理筆劃。

流量分析提示可藉由提供額外的內容給筆跡分析器來改善辨識精確度。 其他內容資訊可協助筆跡分析器限制可能的辨識結果數目。 例如，您可以藉由定義事實和預期的文字，或將輸入結構化成辨識指南，來縮小範圍。 如需提供內容給筆跡分析器的詳細資訊，請參閱：

• IInkAnalyzer：：CreateAnalysisHint 方法
• IInkAnalyzer：:D eleteAnalysisHint 方法
• IInkAnalyzer：：GetAnalysisHints 方法
• IInkAnalyzer：：GetAnalysisHintsByName 方法

筆跡分析器會將分析結果表示為字串或 ICoNtextNode 物件的樹狀結構。 若要存取辨識的字串，請使用 IInkAnalyzer：：GetRecognizedString 方法。 若要存取內容節點樹狀結構的根目錄，請使用 IInkAnalyzer：：GetRootNode 方法。 筆跡分析器具有下列方法來尋找特定內容節點或文字。

• IInkAnalyzer：：FindInkLeafNodes 方法
• IInkAnalyzer：：FindInkLeafNodesForStrokes 方法
• IInkAnalyzer：：FindLeafNodes 方法
• IInkAnalyzer：：FindNode 方法
• IInkAnalyzer：：FindNodesOfType 方法
• IInkAnalyzer：：FindNodesOfTypeForStrokes 方法
• IInkAnalyzer：：FindNodesOfTypeInSubTree 方法
• IInkAnalyzer：：FindNodesWithCallBack 方法
• IInkAnalyzer：：FindNodesWithCallBackInSubTree 方法

若要使用替代分析結果，請使用下列其中一種方法。

• IInkAnalyzer：：GetAlternates 方法
• IInkAnalyzer：：GetAlternatesForCoNtextNodes 方法
• IInkAnalyzer：：GetAlternatesForStrokes 方法
• IInkAnalyzer：：ModifyTopAlternate 方法
• IInkAnalyzer：：ModifyTopAlternateWithConfirmation 方法

若要儲存分析結果，請使用下列其中一種方法。

• IInkAnalyzer：：SaveResults 方法
• IInkAnalyzer：：SaveResultsForNodes 方法
• IInkAnalyzer：：SaveResultsForStrokes 方法

若要載入儲存的結果，請使用 IInkAnalyzer：：LoadResults 方法。

如需使用 IInkAnalyzer 分析筆跡的詳細資訊，請參閱 筆跡分析概觀。

規格需求

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

另請參閱

AnalysisModes

IAnalysisAlternate

IAnalysisStatus

ICoNtextLink

ICoNtextNode

筆跡分析參考