ContextNodeCreatedEventHandler Delegate

Article
10/19/2012

Represents the method that will handle the ContextNodeCreated event of an InkAnalyzer.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink.Analysis (in Microsoft.Ink.Analysis.dll)

Syntax

'Declaration
Public Delegate Sub ContextNodeCreatedEventHandler ( _
    sender As Object, _
    e As ContextNodeCreatedEventArgs _
)
'Usage
Dim instance As New ContextNodeCreatedEventHandler(AddressOf HandlerMethod)

public delegate void ContextNodeCreatedEventHandler(
    Object sender,
    ContextNodeCreatedEventArgs e
)

public delegate void ContextNodeCreatedEventHandler(
    Object^ sender, 
    ContextNodeCreatedEventArgs^ e
)

JScript does not support delegates.

Parameters

sender
Type: System.Object

The source of the event.

e
Type: Microsoft.Ink.ContextNodeCreatedEventArgs

The event data.

Remarks

When you create a ContextNodeCreatedEventHandler delegate, you identify the method that handles the event. To associate the event with your event handler, add an instance of the delegate to the event. The event handler is called whenever the event occurs, unless you remove the delegate. For more information about event-handler delegates, see Events and Delegates.

Examples

The following example defines a method, AddContextNode, that handles the ContextNodeCreated event. The event information is passed to the document model object, theDocumentModel.

This example does not provide the definition of the document model or demonstrate how it processes the information passed to it.

'/ <summary> 
'/ Handles the InkAnalyzer.ContextNodeCreated event. 
'/ </summary> 
'/ <param name="sender">The source of the event.</param> 
'/ <param name="e">The event data.</param> 
'/ <remarks> 
'/ Note: when this event is fired, the ContextNode has not been populated 
'/ with extended and other properties. Handle the ContextNodePropertiesUpdated 
'/ event to populate the corresponding ContextNode in the document model. 
'/ </remarks> 
Private Sub AddContextNode( _
    ByVal sender As Object, _
    ByVal e As Microsoft.Ink.ContextNodeCreatedEventArgs)

    ' Do not add unclassified ink nodes to the document model. 
    If Microsoft.Ink.ContextNodeType.UnclassifiedInk _
        <> e.NodeCreated.Type Then 

        Me.theDocumentModel.AddNode(e.NodeCreated)
    End If 

End Sub 'AddContextNode

        /// <summary> 
        /// Handles the InkAnalyzer.ContextNodeCreated event. 
        /// </summary> 
        /// <param name="sender">The source of the event.</param>
        /// <param name="e">The event data.</param>
        /// <remarks> 
        /// Note: when this event is fired, the ContextNode has not been populated 
        /// with extended and other properties. Handle the ContextNodePropertiesUpdated 
        /// event to populate the corresponding ContextNode in the document model. 
        /// </remarks> 
        private void AddContextNode(
            object sender, Microsoft.Ink.ContextNodeCreatedEventArgs e)
        {
            // Do not add unclassified ink nodes to the document model. 
            if (Microsoft.Ink.ContextNodeType.UnclassifiedInk
                != e.NodeCreated.Type)
            {
                this.theDocumentModel.AddNode(e.NodeCreated);
            }
        }

Platforms

Windows 7, Windows Vista, Windows Server 2008 R2, Windows Server 2008

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.0