InkAnalyzer.Activity, événement

Article
11/05/2008

Mise à jour : November 2007

Se produit pour indiquer que l'analyse s'exécute dans la méthode Analyze ou BackgroundAnalyze.

Espace de noms : System.Windows.Ink
Assembly : IAWinFX (dans IAWinFX.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. Attention, cet événement n'indique pas la progression de l'analyseur d'entrée manuscrite.

Vos objectifs de gestion de l'événement Activity peuvent être les suivants :

Indiquer une activité à l'utilisateur.
Traiter l'entrée d'utilisateur pendant l'analyse synchrone.
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. L'analyseur d'entrée manuscrite déclenche l'événement Activity avant et après l'accès à un InkRecognizer pendant la phase de reconnaissance de l'écriture manuscrite.

Le nombre des événements d'activité qu'un InkRecognizer génère est affecté par :

InkRecognizer que le InkAnalyzer 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 le 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 dispose d'un indicateur d'annulation, le gestionnaire d'événements appelle la méthode 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 InkAnalyzer = sender

        ' Abort the analysis and get the region that was being analyzed.
        Dim theAnalysisRegion As 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.
        InkAnalyzer theInkAnalyzer =
            sender as InkAnalyzer;

        // Abort the analysis and get the region that was being analyzed.
        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

System.Windows.Ink, espace de noms

Partager via