Auf Englisch lesen

Freigeben über


InkAnalyzerBase.ActivityBase-Ereignis

Tritt während der Aufrufe der Analyze-Methode oder der BackgroundAnalyze-Methode auf.

Namespace:  System.Windows.Ink.AnalysisCore
Assembly:  IACore (in IACore.dll)

Syntax

'Declaration
Public Event ActivityBase As ActivityBaseEventHandler
'Usage
Dim instance As InkAnalyzerBase
Dim handler As ActivityBaseEventHandler

AddHandler instance.ActivityBase, handler
public event ActivityBaseEventHandler ActivityBase
public:
 event ActivityBaseEventHandler^ ActivityBase {
    void add (ActivityBaseEventHandler^ value);
    void remove (ActivityBaseEventHandler^ value);
}
/** @event */
public void add_ActivityBase (ActivityBaseEventHandler value)
/** @event */
public void remove_ActivityBase (ActivityBaseEventHandler 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 zum Synchronisieren von Anwendungsdaten mit InkAnalyzerBase finden Sie unter Data Proxy with Ink Analysis.

Beispiele

In diesem Beispiel wird ein Ereignishandler für das ActivityBase-Ereignis des Freihandanalysemoduls definiert. Wenn der Analysevorgang abgebrochen wird, ruft der Ereignishandler Abort für das InkAnalyzerBase auf, das 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 theInkAnalyzerBase_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 analyzer that raised the Activity event.
        Dim theInkAnalyzerBase As System.Windows.Ink.AnalysisCore.InkAnalyzerBase = _
            DirectCast(sender, System.Windows.Ink.AnalysisCore.InkAnalyzerBase)

        ' Abort the analysis and get the region that was being analyzed.
        Dim theAnalysisRegionBase As System.Windows.Ink.AnalysisCore.AnalysisRegionBase = _
            theInkAnalyzerBase.Abort()

        ' Add the region that was being analyzed to the analyzer's dirty region.
        theInkAnalyzerBase.DirtyRegion.Union(theAnalysisRegionBase)
    End If

End Sub 'theInkAnalyzerBase_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 theInkAnalyzerBase_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 analyzer that raised the Activity event.
        System.Windows.Ink.AnalysisCore.InkAnalyzerBase theInkAnalyzerBase =
            sender as System.Windows.Ink.AnalysisCore.InkAnalyzerBase;

        // Abort the analysis and get the region that was being analyzed.
        System.Windows.Ink.AnalysisCore.AnalysisRegionBase theAnalysisRegionBase =
            theInkAnalyzerBase.Abort();

        // Add the region that was being analyzed to the analyzer's dirty region.
        theInkAnalyzerBase.DirtyRegion.Union(theAnalysisRegionBase);
    }
}

Plattformen

Windows Vista, Windows XP SP2, Windows Server 2003

.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

Siehe auch

Referenz

InkAnalyzerBase-Klasse

InkAnalyzerBase-Member

System.Windows.Ink.AnalysisCore-Namespace