InkAnalyzer.Activity Event

Article
12/12/2007

Occurs during calls to the Analyze or BackgroundAnalyze method.

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)

In JScript, you can handle the events defined by a class, but you cannot define your own.

Not applicable.

Remarks

This event indicates that the ink analyzer is performing ink analysis. This event does not indicate the progress of the ink analyzer in this task.

Handle this event in the following circumstances.

To indicate activity to the user.
To process user input during synchronous analysis.
To receive notification of system requests, such as repainting of the application's window.

The ink analyzer raises this event frequently during the layout analysis phase and the writing and drawing classification phase of ink analysis. The ink analyzer raises this event before and after accessing an ink recognizer during the handwriting recognition phase.

The number of activity events an ink analyzer generates is affected by the following.

The ink recognizer that the ink analyzer applies to ink recognition.
The number and length of strokes that the ink analyzer is analyzing.
The number of strokes that are classified as writing.

For more information about synchronizing your application data with the InkAnalyzer, see Data Proxy with Ink Analysis.

Example

This example defines an event handler for the ink analyzer's Activity event. If the analysis operation should be canceled, the event handler calls Abort on the InkAnalyzer that generated the event and updates the analyzer's DirtyRegion property.

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

Platforms

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

Version Information

.NET Framework

Supported in: 3.0

Share via