InkAnalyzer.BackgroundAnalyze 方法
執行非同步筆墨分析,包括配置分析、書寫和繪圖分類以及手寫輸入辨識。
命名空間: Microsoft.Ink
組件: Microsoft.Ink.Analysis (在 Microsoft.Ink.Analysis.dll 中)
語法
'宣告
Public Function BackgroundAnalyze As Boolean
'用途
Dim instance As InkAnalyzer
Dim returnValue As Boolean
returnValue = instance.BackgroundAnalyze()
public bool BackgroundAnalyze()
public:
bool BackgroundAnalyze()
public boolean BackgroundAnalyze()
public function BackgroundAnalyze() : boolean
傳回值
型別:System.Boolean
如果非同步筆墨分析已啟動,則為 true,否則為 false。
備註
呼叫這個方法時,InkAnalyzer 會在背景執行緒上執行筆墨分析。InkAnalyzer 會引發執行緒 (InkAnalyzer 會在該執行緒上建立) 上背景分析所產生的事件。
SynchronizingObject 屬性控制 InkAnalyzer 要在哪個執行緒上引發背景分析期間產生的事件。
這個方法在下列情況下不會開始進行新的背景分析作業。
筆墨分析器目前正在執行背景分析。
DirtyRegion 表示空的區域。
在呼叫 Analyze 或 BackgroundAnalyze 期間,InkAnalyzer 會分析其 DirtyRegion 中的筆墨。不過,筆墨分析器可將分析作業擴展為包含鄰近區域。
這個方法會將 DirtyRegion 屬性設為空區域。
如果筆劃資料已在呼叫 BackgroundAnalyze 之後加入至筆墨分析器,則筆墨分析器可能會在筆墨分析的協調階段更新 DirtyRegion 屬性。
AnalysisModes 屬性的值會指定筆墨分析器執行背景分析的方式。如需筆墨分析的詳細資訊,請參閱Ink Analysis Overview。
這個方法會在下列情況下擲回例外狀況。
您應用程式之 AnalysisModes 屬性中的 AutomaticReconciliationEnabled 旗標已清除,而且並未加入至 ReadyToReconcile 事件的事件處理常式。
您的應用程式尚未加入 IntermediateResultsUpdated 或 ResultsUpdated 事件的事件處理常式。
範例
這個範例會在筆墨分析器目前未執行筆墨分析時,在 InkAnalyzer, theInkAnalyzer 上啟動背景筆墨分析。
If Not theInkAnalyzer.IsAnalyzing Then
Dim started As Boolean = theInkAnalyzer.BackgroundAnalyze()
End If
if (!theInkAnalyzer.IsAnalyzing)
{
bool started = theInkAnalyzer.BackgroundAnalyze();
}
平台
Windows Vista
.NET Framework 和 .NET Compact Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊,請參閱 .NET Framework 系統需求。
版本資訊
.NET Framework
支援版本:3.0