InkAnalyzerBase.Analyze メソッド

2008-10-28

同期インク分析を実行します。

名前空間 : System.Windows.Ink.AnalysisCore
アセンブリ : IACore (IACore.dll 内)

構文

'宣言
Public Function Analyze As AnalysisStatusBase
'使用
Dim instance As InkAnalyzerBase
Dim returnValue As AnalysisStatusBase

returnValue = instance.Analyze()

public AnalysisStatusBase Analyze()

public:
AnalysisStatusBase^ Analyze()

public AnalysisStatusBase Analyze()

public function Analyze() : AnalysisStatusBase

戻り値

型 : System.Windows.Ink.AnalysisCore.AnalysisStatusBase
分析処理のステータス。

解説

このメソッドは、同期インク分析処理を開始します。インク分析には、レイアウト分析、書き込みと描画分類、および手書き認識が含まれます。分析処理が完了した後、このメソッドに戻ります。

InkAnalyzerBase は、Analyze または BackgroundAnalyze の呼び出し時に、その DirtyRegion 内でインクを分析します。ただし、インクアナライザは分析処理を拡張して、隣接する領域を含めることができます。

このメソッドは、InkAnalyzerBase オブジェクトの DirtyRegion を空の領域に設定します。別のスレッドが、分析されていないストロークデータを追加した場合、InkAnalyzerBase は、分析の調整段階で、分析されていないストロークの境界ボックスをその DirtyRegion に追加します。

このメソッドは、アプリケーションが UpdateStrokesCacheBase イベントのイベントハンドラを追加しない場合に例外をスローします。

InkAnalyzerBase は、このメソッドに応答して ResultsUpdatedBase および IntermediateResultsUpdatedBase イベントを発生させません。

インク分析の実行方法を変更するには、AnalysisModes プロパティを使用します。

インク分析の詳細については、「Ink Analysis Overview」を参照してください。

例

この例では、アナライザの DirtyRegion が空でない場合、InkAnalyzerBase、theInkAnalyzerBase でインク分析を実行します。

' Only start ink analysis if the dirty region is not empty.
Dim theStatus As System.Windows.Ink.AnalysisCore.AnalysisStatusBase = Nothing
If Not theInkAnalyzerBase.DirtyRegion.IsEmpty Then

    ' Perform the ink analysis.
    theStatus = theInkAnalyzerBase.Analyze()

End If

// Only start ink analysis if the dirty region is not empty.
System.Windows.Ink.AnalysisCore.AnalysisStatusBase theStatus = null;
if (!theInkAnalyzerBase.DirtyRegion.IsEmpty)
{
    // Perform the ink analysis.
    theStatus = theInkAnalyzerBase.Analyze();
}