InkAnalyzer.FindNodes, méthode (MatchesCriteriaCallback, Object, ContextNode)

Article
11/05/2008

Mise à jour : November 2007

Retourne les objets ContextNode qui sont des descendants du ContextNode spécifié et qui correspondent aux critères spécifiés.

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

Syntaxe

'Déclaration
Public Function FindNodes ( _
    criteria As MatchesCriteriaCallback, _
    data As Object, _
    nodeToSearch As ContextNode _
) As ContextNodeCollection
'Utilisation
Dim instance As InkAnalyzer
Dim criteria As MatchesCriteriaCallback
Dim data As Object
Dim nodeToSearch As ContextNode
Dim returnValue As ContextNodeCollection

returnValue = instance.FindNodes(criteria, _
    data, nodeToSearch)

public ContextNodeCollection FindNodes(
    MatchesCriteriaCallback criteria,
    Object data,
    ContextNode nodeToSearch
)

public:
ContextNodeCollection^ FindNodes(
    MatchesCriteriaCallback^ criteria, 
    Object^ data, 
    ContextNode^ nodeToSearch
)

public ContextNodeCollection FindNodes(
    MatchesCriteriaCallback criteria,
    Object data,
    ContextNode nodeToSearch
)

public function FindNodes(
    criteria : MatchesCriteriaCallback, 
    data : Object, 
    nodeToSearch : ContextNode
) : ContextNodeCollection

Paramètres

criteria
Type : Microsoft.Ink.MatchesCriteriaCallback
Fonction déléguée qui détermine si un ContextNode répond ou non aux critères spécifiés.

data
Type : System.Object
Données facultatives supplémentaires qui peuvent être passées dans la fonction déléguée. Cette méthode passe ces données au délégué avec chaque appel. Elle ne les modifie pas et ne les examine pas.

nodeToSearch
Type : Microsoft.Ink.ContextNode
ContextNode dont les descendants sont recherchés.

Valeur de retour

Type : Microsoft.Ink.ContextNodeCollection
ContextNodeCollection contenant tous les objets ContextNode qui sont des descendants du nœud spécifié et qui correspondent aux critères spécifiés.

Exemples

L'exemple suivant recherche dans un InkAnalyzer, theInkAnalyzer la collection d'objets ContextNode qui répondent aux critères spécifiés dans le délégué LineIsLowerThan. L'entier signé 32 bits, yValue est passé au délégué LineIsLowerThan. La recherche est restreinte aux descendants du WritingRegionNode, writingRegion.

Dim isLineLowerThanCallback As _
    New Microsoft.Ink.MatchesCriteriaCallback(AddressOf LineIsLowerThan)
Dim nodesInRegionBelowYValue As ContextNodeCollection = _
    theInkAnalyzer.FindNodes(isLineLowerThanCallback, yValue, writingRegion)

            Microsoft.Ink.MatchesCriteriaCallback
                isLineLowerThanCallback = new Microsoft.Ink.MatchesCriteriaCallback(LineIsLowerThan);
            ContextNodeCollection nodesInRegionBelowYValue =
                theInkAnalyzer.FindNodes(isLineLowerThanCallback, yValue, writingRegion);

L'exemple suivant définit la méthode LineIsLowerThan, qui retourne la valeur true si le ContextNode est un LineNode et si le bas du cadre englobant est inférieur à un entier passé. Notez que plus la valeur des ordonnées est élevée, plus l'affichage à l'écran est bas. Par conséquent, la collection nodesBelowYValue contient toutes les lignes dont les traits sont situés sous la valeur, 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);
        }

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.