InkAnalyzer.Activity-Ereignis
Tritt während der Aufrufe der Analyze-Methode oder der BackgroundAnalyze-Methode auf.
Namespace: Microsoft.Ink
Assembly: Microsoft.Ink.Analysis (in Microsoft.Ink.Analysis.dll)
Syntax
'Declaration
Public Event Activity As ActivityEventHandler
'Usage
Dim instance As InkAnalyzer
Dim handler As ActivityEventHandler
AddHandler instance.Activity, handler
public event ActivityEventHandler Activity
public:
event ActivityEventHandler^ Activity {
void add (ActivityEventHandler^ value);
void remove (ActivityEventHandler^ value);
}
/** @event */
public void add_Activity (ActivityEventHandler value)
/** @event */
public void remove_Activity (ActivityEventHandler value)
JScript unterstützt keine Ereignisse.
Hinweise
Dieses Ereignis gibt an, dass das Freihandanalysemodul eine Freihandanalyse ausführt. Dieses Ereignis gibt nicht den Fortschritt des Freihandanalysemoduls in diesem Task an.
Behandeln Sie dieses Ereignis in den folgenden Situationen.
Um dem Benutzer Aktivität anzuzeigen.
Um während einer synchronen Analyse Benutzereingaben zu verarbeiten.
Um Benachrichtigungen über Systemanforderungen zu erhalten, z. B. über das Aktualisieren des Anwendungsfensters.
Das Freihandanalysemodul löst dieses Ereignis häufig während der Layoutanalysephase und der Schrift- und Zeichnungsklassifizierungsphase der Freihandanalyse aus. Das Freihandanalysemodul löst dieses Ereignis vor und nach dem Zugriff auf ein Freihanderkennungsmodul während der Handschrifterkennungsphase aus.
Die folgenden Faktoren beeinflussen die Anzahl von Aktivitätsereignissen, die ein Freihandanalysemodul generiert.
Das Freihanderkennungsmodul, das vom Freihandanalysemodul für die Freihanderkennung verwendet wird.
Die Anzahl und Länge der Striche, die vom Freihandanalysemodul analysiert werden.
Die Anzahl der Striche, die als Text klassifiziert sind.
Weitere Informationen über das Synchronisieren von Anwendungsdaten mit InkAnalyzer finden Sie unter Data Proxy with Ink Analysis.
Beispiele
In diesem Beispiel wird ein Ereignishandler für das Activity-Ereignis des Freihandanalysemoduls definiert. Wenn der Analysevorgang abgebrochen wird, ruft der Ereignishandler Abort für den InkAnalyzer auf, der das Ereignis generiert hat, und aktualisiert die DirtyRegion-Eigenschaft des Analysemoduls.
''' <summary>
''' The ink analyzer's Activity event handler.
''' </summary>
''' <param name="sender">The source of the event.</param>
''' <param name="e">The event data.</param>
Sub theInkAnalyzer_Activity(ByVal sender As Object, ByVal e As EventArgs)
Dim abortAnalysis As Boolean = False
' Check if the analysis operation should be canceled.
' Abort analysis if the flag to do so is set.
If abortAnalysis Then
' Get the InkAnalyzer that raised the Activity event.
Dim theInkAnalyzer As Microsoft.Ink.InkAnalyzer = _
DirectCast(sender, Microsoft.Ink.InkAnalyzer)
' Abort the analysis and get the region that was being analyzed.
Dim theAnalysisRegion As Microsoft.Ink.AnalysisRegion = _
theInkAnalyzer.Abort()
' Add the region that was being analyzed to the analyzer's dirty region.
theInkAnalyzer.DirtyRegion.Union(theAnalysisRegion)
End If
End Sub 'theInkAnalyzer_Activity
/// <summary>
/// The ink analyzer's Activity event handler.
/// </summary>
/// <param name="sender">The source of the event.</param>
/// <param name="e">The event data.</param>
void theInkAnalyzer_Activity(object sender, EventArgs e)
{
bool abortAnalysis = false;
// Check if the analysis operation should be canceled.
// Abort analysis if the flag to do so is set.
if (abortAnalysis)
{
// Get the InkAnalyzer that raised the Activity event.
Microsoft.Ink.InkAnalyzer theInkAnalyzer =
sender as Microsoft.Ink.InkAnalyzer;
// Abort the analysis and get the region that was being analyzed.
Microsoft.Ink.AnalysisRegion theAnalysisRegion = theInkAnalyzer.Abort();
// Add the region that was being analyzed to the analyzer's dirty region.
theInkAnalyzer.DirtyRegion.Union(theAnalysisRegion);
}
}
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