Metodo RootNode.GetNodesFromTextRange (Int32%, Int32%, ContextNodeCollection)

Articolo
10/29/2008

Aggiornamento: novembre 2007

Restituisce un insieme di oggetti ContextNode discendenti rilevanti per l'intervallo di testo specificato nella stringa riconosciuta all'interno di un insieme di nodi discendenti.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink.Analysis (in Microsoft.Ink.Analysis.dll)

Sintassi

'Dichiarazione
Public Function GetNodesFromTextRange ( _
    ByRef start As Integer, _
    ByRef length As Integer, _
    subTree As ContextNodeCollection _
) As ContextNodeCollection
'Utilizzo
Dim instance As RootNode
Dim start As Integer
Dim length As Integer
Dim subTree As ContextNodeCollection
Dim returnValue As ContextNodeCollection

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

public ContextNodeCollection GetNodesFromTextRange(
    ref int start,
    ref int length,
    ContextNodeCollection subTree
)

public:
ContextNodeCollection^ GetNodesFromTextRange(
    int% start, 
    int% length, 
    ContextNodeCollection^ subTree
)

public ContextNodeCollection GetNodesFromTextRange(
    /** @ref */int start,
    /** @ref */int length,
    ContextNodeCollection subTree
)

public function GetNodesFromTextRange(
    start : int, 
    length : int, 
    subTree : ContextNodeCollection
) : ContextNodeCollection

Parametri

start
Tipo: System.Int32%
Inizio dell'intervallo di testo nella parte subTree della stringa riconosciuta.

length
Tipo: System.Int32%
Lunghezza dell'intervallo di testo nella stringa riconosciuta.

subTree
Tipo: Microsoft.Ink.ContextNodeCollection
Oggetti ContextNode discendenti a cui limitare la ricerca.

Valore restituito

Tipo: Microsoft.Ink.ContextNodeCollection
Insieme di oggetti ContextNode discendenti rilevanti per l'intervallo di testo specificato nella stringa riconosciuta all'interno dell'insieme di nodi discendenti.

Note

L'intervallo di testo specificato deve essere relativo alla parte subTree della stringa riconosciuta di questo oggetto RootNode, anziché alla stringa riconosciuta dell'intero oggetto RootNode.

I parametri start e length sono riferimenti perché è possibile modificare i relativi valori. Ad esempio, il valore restituito di GetRecognizedString è "I am late" e vengono passati i valori di start = 6 e length = 1, corrispondenti alla lettera "a". È quindi probabile che ContextNodeCollection disponga di un solo oggetto ContextNode, ovvero l'oggetto InkWordNode che corrisponde alla parola "late". In questo caso, il valore di start viene modificato in 5 e il valore di length viene modificato in 4, per creare una corrispondenza con l'intera parola "late".

Nota

Il parametro start è relativo ai nodi nel parametro subTree. Nell'esempio precedente, se si passa un parametro subTree con nodi per "am" e "late", ma non per "I", un parametro start impostato su 3 e una lunghezza impostata su 4 rappresentano l'intervallo di testo per la parola "late".

Esempi

Nell'esempio seguente viene accettato un oggetto ContextNodeCollection, lastRegionCollection che contiene un oggetto ContextNode che corrisponde all'ultimo paragrafo di un oggetto RootNode, theRootNode. Tutti gli oggetti Strokes vengono quindi contrassegnati in nero, ad eccezione di quelli che corrispondono al testo selezionato nell'ultima riga, visualizzati in rosso.

' Get the nodes that correspond to this start and length
Dim selectedNodes As ContextNodeCollection = theRootNode.GetNodesFromTextRange(start, length, lastRegionCollection)

' Set all strokes to black
Dim inkStroke As Stroke
For Each inkStroke In theRootNode.Strokes
    inkStroke.DrawingAttributes = New DrawingAttributes(Color.Black)
Next inkStroke
' Set strokes in the collection to red
Dim node As ContextNode
For Each node In selectedNodes
    For Each inkStroke In node.Strokes
        inkStroke.DrawingAttributes = New DrawingAttributes(Color.Red)
    Next inkStroke
Next node

            // Get the nodes that correspond to this start and length
            ContextNodeCollection selectedNodes =
                theRootNode.GetNodesFromTextRange(ref start, ref length, lastRegionCollection);

            // Set all strokes to black
            foreach (Stroke stroke in theRootNode.Strokes)
                stroke.DrawingAttributes = new DrawingAttributes(Color.Black);

            // Set strokes in the collection to red
            foreach (ContextNode node in selectedNodes)
            {
                foreach (Stroke stroke in node.Strokes)
                {
                    stroke.DrawingAttributes = new DrawingAttributes(Color.Red);
                }
            }

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.