レイアウト分析、書き込みと描画分類、および手書き認識が含まれる非同期インク分析を実行します。
名前空間 : 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
参照
参照
InkAnalyzerBaseAnalysisModes()
InkAnalyzerBaseDirtyRegion()
InkAnalyzerBaseRootNode()
InkAnalyzerBaseAnalyze()