Partager via


InkAnalyzer.Activity, événement

Mise à jour : November 2007

Se produit pendant des appels à la méthode Analyze ou BackgroundAnalyze.

Espace de noms :  Microsoft.Ink
Assembly :  Microsoft.Ink.Analysis (dans Microsoft.Ink.Analysis.dll)

Syntaxe

'Déclaration
Public Event Activity As ActivityEventHandler
'Utilisation
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 ne prend pas en charge les événements.

Notes

Cet événement indique que l'analyseur d'entrée manuscrite exécute l'analyse d'entrée manuscrite. Cet événement n'indique pas la progression de l'analyseur d'entrée manuscrite dans cette tâche.

Gérez cet événement dans les circonstances suivantes.

  • Pour indiquer l'activité à l'utilisateur.

  • Pour traiter l'entrée d'utilisateur pendant l'analyse synchrone.

  • Pour recevoir une notification des demandes du système, telles que l'application d'une nouvelle peinture à la fenêtre de l'application.

L'analyseur d'entrée manuscrite déclenche fréquemment cet événement pendant la phase d'analyse de disposition et la phase de classification de l'écriture et du dessin de l'analyse d'entrée manuscrite. L'analyseur d'entrée manuscrite déclenche cet événement avant et après l'accès à un module de reconnaissance de l'écriture manuscrite pendant la phase de reconnaissance de l'écriture manuscrite.

Le nombre d'événements d'activité qu'un analyseur d'entrée manuscrite peut générer est affecté par les éléments suivants.

  • Module de reconnaissance de l'écriture manuscrite que l'analyseur d'entrée manuscrite applique à la reconnaissance de l'écriture manuscrite.

  • Nombre et longueur des traits que l'analyseur d'entrée manuscrite analyse.

  • Nombre de traits classés en tant qu'écriture.

Pour plus d'informations sur la synchronisation des données d'application avec InkAnalyzer, consultez Data Proxy with Ink Analysis.

Exemples

Cet exemple définit un gestionnaire d'événements pour l'événement Activity de l'analyseur d'entrée manuscrite. Si l'opération d'analyse doit être annulée, le gestionnaire d'événements appelle Abort sur le InkAnalyzer qui a généré l'événement et met à jour la propriété DirtyRegion de l'analyseur.

''' <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);
    }
}

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Informations de version

.NET Framework

Pris en charge dans : 3.0

Voir aussi

Référence

InkAnalyzer, classe

Membres InkAnalyzer

Microsoft.Ink, espace de noms