MatchesCriteriaCallback Delegate

Article
10/19/2012

Represents a function that is used to evaluate if a ContextNode object meets or fails a specified criteria.

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

Syntax

'Declaration
Public Delegate Function MatchesCriteriaCallback ( _
    visitingNode As ContextNode, _
    data As Object _
) As Boolean
'Usage
Dim instance As New MatchesCriteriaCallback(AddressOf HandlerMethod)

public delegate bool MatchesCriteriaCallback(
    ContextNode visitingNode,
    Object data
)

public delegate bool MatchesCriteriaCallback(
    ContextNode^ visitingNode, 
    Object^ data
)

JScript does not support delegates.

Parameters

visitingNode
Type: Microsoft.Ink.ContextNode

The ContextNode object that will be checked against the criteria.

data
Type: System.Object

Optional data that can be used for the criteria.

Return Value

Type: System.Boolean
Whether the visitingNode object matches the criteria.

Examples

The following example finds the collection of ContextNode objects in an InkAnalyzer, theInkAnalyzer, that satisfies the criteria specified in the MatchesCriteriaCallBack delegate function LineIsLowerThan by using an integer, yValue.

Dim lineIsLowerThanCallback As _
    New Microsoft.Ink.MatchesCriteriaCallback(AddressOf LineIsLowerThan)
Dim nodesBelowYValue As ContextNodeCollection = _
    theInkAnalyzer.FindNodes(lineIsLowerThanCallback, yValue)

           Microsoft.Ink.MatchesCriteriaCallback
                lineIsLowerThanCallback = new Microsoft.Ink.MatchesCriteriaCallback(LineIsLowerThan);
            ContextNodeCollection nodesBelowYValue =
                theInkAnalyzer.FindNodes(lineIsLowerThanCallback, yValue);

LineIsLowerThan returns a true if the ContextNode is a LineNode and if the bottom of the bounding box is lower than an integer that is passed in. (Remember that higher y values appear lower on the screen.) Therefore, the nodesBelowYValue collection contains all lines with strokes below the value, yValue.

Public Function LineIsLowerThan(ByVal node As Microsoft.Ink.ContextNode, _
                                ByVal data As Object) As Boolean 

    ' Return false if not a line 
    If Not TypeOf node Is LineNode Then 
        Return False 
    End If 
    ' Check if bottom is lower than yValue passed in 
    Dim yValue As Integer = Fix(data)
    Return node.Location.GetBounds().Bottom > yValue

End Function 'LineIsLowerThan

       public bool LineIsLowerThan(Microsoft.Ink.ContextNode node, object data)
        {
            // Return false if not a line 
            if (!(node is LineNode))
                return false;

            // Check if bottom is lower than yValue passed in 
            int yValue = (int)data;
            return (node.Location.GetBounds().Bottom > yValue);
        }

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

Share via