共用方式為

InkAnalyzer.BackgroundAnalyze 方法

  • 發行項

執行非同步筆墨分析，包括配置分析、書寫和繪圖分類以及手寫辨識。

命名空間：  System.Windows.Ink
組件：  IAWinFX (在 IAWinFX.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 會在用來建立 SynchronizingObject 的相同執行緒上引發筆墨分析所產生的事件。如果 InkAnalyzer.SynchronizingObject 屬性為 nullNull 參照 (即 Visual Basic 中的 Nothing)，InkAnalyzer 也會在背景執行緒上引發這些事件。

SynchronizingObject 屬性可控制 InkAnalyzer 要引發 (於背景分析期間產生的) 事件所針對的執行緒。

這個方法在下列情況下，不會開始執行新的背景分析作業。

  • 筆墨分析器目前正在執行背景分析。

  • DirtyRegion 表示空白區域。

即使 InkAnalyzer 在 Analyze 或 BackgroundAnalyze 呼叫期間分析其 DirtyRegion 內的筆墨，它還是可以擴展分析作業的範圍，使其包含鄰近區域。

這個方法會將 DirtyRegion 屬性設為空白區域。

如果筆劃資料已在呼叫 BackgroundAnalyze 之後加入至筆墨分析器，則筆墨分析器可能會在筆墨分析的協調階段更新 DirtyRegion 屬性。

AnalysisModes 屬性的值會指定筆墨分析器執行其背景分析的方式。如需筆墨分析的詳細資訊，請參閱Ink Analysis Overview。

這個方法會在下列情況下擲回例外狀況。

  • 您應用程式之 AnalysisModes 屬性中的 [F:System.Windows.Ink. AnalysisModes.AutomaticReconciliationEnabled] 旗標已清除，而且尚未加入 ReadyToReconcile 事件的事件處理常式。

  • 您的應用程式中尚未加入 IntermediateResultsUpdated 事件或 Results() 事件的事件處理常式。

範例

這個範例會在筆墨分析器目前未執行筆墨分析時，在名為 theInkAnalyzer 的 InkAnalyzer 上開始執行背景筆墨分析。

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

請參閱

參考

InkAnalyzer 類別

InkAnalyzer 成員

System.Windows.Ink 命名空間

InkAnalyzerBaseAnalysisModes()

InkAnalyzerBaseDirtyRegion()

InkAnalyzerBaseRootNode()

InkAnalyzerBaseAnalyze()