InkAnalyzer.Analyze-Methode
Führt die synchrone Freihandanalyse aus.
Namespace: Microsoft.Ink
Assembly: Microsoft.Ink.Analysis (in Microsoft.Ink.Analysis.dll)
Syntax
'Declaration
Public Function Analyze As AnalysisStatus
'Usage
Dim instance As InkAnalyzer
Dim returnValue As AnalysisStatus
returnValue = instance.Analyze()
public AnalysisStatus Analyze()
public:
AnalysisStatus^ Analyze()
public AnalysisStatus Analyze()
public function Analyze() : AnalysisStatus
Rückgabewert
Typ: Microsoft.Ink.AnalysisStatus
Der Status des Analysevorgangs.
Hinweise
Diese Methode startet eine synchrone Freihandanalyse. Die Freihandanalyse umfasst die Layoutanalyse, die Schrift- und Zeichnungsklassifizierung und die Handschrifterkennung. Der Betrieb wird wiederaufgenommen, sobald der Analysevorgang abgeschlossen wurde. InkAnalyzer analysiert Freihanddaten nur innerhalb seiner DirtyRegion.
Diese Methode legt die DirtyRegion des InkAnalyzer-Objekts auf einen leeren Bereich fest. Wenn ein anderer Thread Strichdaten hinzugefügt hat, die noch nicht analysiert wurden, fügt InkAnalyzer das umgebende Feld der nicht analysierten Striche während der Abgleichsphase der Analyse seiner DirtyRegion hinzu.
InkAnalyzer löst das ResultsUpdated-Ereignis und das IntermediateResultsUpdated-Ereignis nicht als Reaktion auf diese Methode aus.
Verwenden Sie die AnalysisModes-Eigenschaft des InkAnalyzer-Objekts, um die Art der Ausführung einer Freihandanalyse zu ändern.
Weitere Informationen zur Freihandanalyse finden Sie unter Ink Analysis Overview.
Beispiele
Im folgenden Beispiel wird ein Ereignishandler für das Click-Ereignis eines Menüelements definiert. Der Ereignishandler führt eine synchrone Freihandanalyse aus, wenn DirtyRegion für das InkAnalyzer-Objekt nicht leer ist. Er fügt einen InkAnalyzer.Activity-Ereignishandler an und führt die Analyse aus. Dann entfernt er den Ereignishandler und ruft eine Hilfsmethode auf, UpdateResults, um das Formular mit den Analyseergebnissen zu aktualisieren.
''' <summary>
''' The Ink menu's Analyze menu item's Click event handler.
''' </summary>
''' <param name="sender">The source of the event.</param>
''' <param name="e">The event data.</param>
Private Sub theInkAnalyzeMenuItem_Click( _
ByVal sender As Object, ByVal e As EventArgs) _
Handles theInkAnalyzeMenuItem.Click
' Only start ink analysis if the dirty region is not empty.
If Not Me.theInkAnalyzer.DirtyRegion.IsEmpty Then
' Attach an activity event handler.
AddHandler Me.theInkAnalyzer.Activity, AddressOf theInkAnalyzer_Activity
' Perform the ink analysis.
Dim theStatus As Microsoft.Ink.AnalysisStatus = Me.theInkAnalyzer.Analyze()
' Remove the activity event handler.
RemoveHandler Me.theInkAnalyzer.Activity, AddressOf theInkAnalyzer_Activity
' Update the analysis results on the form.
Me.UpdateResults(theStatus)
End If
End Sub 'theInkAnalyzeMenuItem_Click
/// <summary>
/// The Ink menu's Analyze menu item's Click event handler.
/// </summary>
/// <param name="sender">The source of the event.</param>
/// <param name="e">The event data.</param>
private void theInkAnalyzeMenuItem_Click(object sender, EventArgs e)
{
// Only start ink analysis if the dirty region is not empty.
if (!this.theInkAnalyzer.DirtyRegion.IsEmpty)
{
// Attach an activity event handler.
this.theInkAnalyzer.Activity +=
new Microsoft.Ink.ActivityEventHandler(
theInkAnalyzer_Activity);
// Perform the ink analysis.
Microsoft.Ink.AnalysisStatus theStatus =
this.theInkAnalyzer.Analyze();
// Remove the activity event handler.
this.theInkAnalyzer.Activity -=
new Microsoft.Ink.ActivityEventHandler(
theInkAnalyzer_Activity);
// Update the analysis results on the form.
this.UpdateResults(theStatus);
}
}
Plattformen
Windows Vista
.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Versionsinformationen
.NET Framework
Unterstützt in: 3.0