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