InkAnalyzerBase.GetNodesFromTextRange, méthode (Int32%, Int32%, ContextNodeBaseCollection)

Article
11/05/2008

Mise à jour : November 2007

Retourne une collection de nœuds de contexte pertinents pour la plage de texte spécifiée des nœuds spécifiés.

Espace de noms : System.Windows.Ink.AnalysisCore
Assembly : IACore (dans IACore.dll)

Syntaxe

'Déclaration
Public Function GetNodesFromTextRange ( _
    ByRef start As Integer, _
    ByRef length As Integer, _
    nodesToSearch As ContextNodeBaseCollection _
) As ContextNodeBaseCollection
'Utilisation
Dim instance As InkAnalyzerBase
Dim start As Integer
Dim length As Integer
Dim nodesToSearch As ContextNodeBaseCollection
Dim returnValue As ContextNodeBaseCollection

returnValue = instance.GetNodesFromTextRange(start, _
    length, nodesToSearch)

public ContextNodeBaseCollection GetNodesFromTextRange(
    ref int start,
    ref int length,
    ContextNodeBaseCollection nodesToSearch
)

public:
ContextNodeBaseCollection^ GetNodesFromTextRange(
    int% start, 
    int% length, 
    ContextNodeBaseCollection^ nodesToSearch
)

public ContextNodeBaseCollection GetNodesFromTextRange(
    /** @ref */int start,
    /** @ref */int length,
    ContextNodeBaseCollection nodesToSearch
)

public function GetNodesFromTextRange(
    start : int, 
    length : int, 
    nodesToSearch : ContextNodeBaseCollection
) : ContextNodeBaseCollection

Paramètres

start
Type : System.Int32%
Référence au début de la plage de texte dans la chaîne reconnue.

length
Type : System.Int32%
Référence à la longueur de la plage de texte dans la chaîne reconnue.

nodesToSearch
Type : System.Windows.Ink.AnalysisCore.ContextNodeBaseCollection
Nœuds de contexte auxquels limiter la recherche.

Valeur de retour

Type : System.Windows.Ink.AnalysisCore.ContextNodeBaseCollection
Collection de nœuds de contexte pertinents pour la plage de texte spécifiée des nœuds de contexte spécifiés.

Notes

Cette méthode modifie les valeurs des paramètres start et length en augmentant la plage de texte jusqu'aux limites du mot le plus proche.

Remarque :
Les paramètres start et length sont relatifs à la chaîne reconnue du paramètre nodesToSearch.

Par exemple, si la chaîne reconnue est « Je vais bien » et que vous appelez cette méthode avec les valeurs de paramètre 9 pour start et 1 pour length, ce qui correspond à la lettre « i » de « bien », cette méthode retourne une collection contenant un seul ContextNodeBase. La collection contient le nœud du mot manuscrit ou du mot texte qui correspond au mot « bien ». Dans cet exemple, cette méthode modifie également la valeur de start sur 8 et la valeur de length sur 4, ce qui correspond au mot « bien ».

Exemples

L'exemple suivant obtient les nœuds de contexte qui contiennent les cinq premiers caractères de la première chaîne reconnue du ContextNodeBaseCollection, theLineNodes. Dans cet exemple, theLineNodes correspond à des nœuds contenus dans le InkAnalyzerBase, theInkAnalyzerBase. L'exemple récupère des propositions de substitution d'analyse pour ces nœuds, puis les affiche à l'aide d'une méthode d'assistance, ShowAlternates.

If 5 < theRecognizedString.Length Then
    ' Get the nodes that correspond to the first five
    ' characters of the results for the line nodes.
    Dim selectionStart As Integer = 0
    Dim selectionLength As Integer = 5
    Dim selectedSubNodes As System.Windows.Ink.AnalysisCore.ContextNodeBaseCollection = _
        theInkAnalyzerBase.GetNodesFromTextRange( _
            selectionStart, selectionLength, theLineNodes)

    ' Get analysis alternates for corresponding nodes.
    Dim theAlternates As System.Windows.Ink.AnalysisCore.AnalysisAlternateBaseCollection = _
        theInkAnalyzerBase.GetAlternates(selectedSubNodes)

    ' Display the alternates using a helper method.
    Me.ShowAlternates("Alternates for the selection:", theAlternates)
End If

if (5 < theRecognizedString.Length)
{
    // Get the nodes that correspond to the first five
    // characters of the results for the line nodes.
    int selectionStart = 0;
    int selectionLength = 5;
    System.Windows.Ink.AnalysisCore.ContextNodeBaseCollection selectedSubNodes =
        theInkAnalyzerBase.GetNodesFromTextRange(
            ref selectionStart, ref selectionLength, theLineNodes);

    // Get analysis alternates for corresponding nodes.
    System.Windows.Ink.AnalysisCore.AnalysisAlternateBaseCollection theAlternates =
        theInkAnalyzerBase.GetAlternates(selectedSubNodes);

    // Display the alternates using a helper method.
    this.ShowAlternates(
        "Alternates for the selection:", theAlternates);
}

Plateformes

Windows Vista, Windows XP SP2, Windows Server 2003

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.