Metodo LineNode.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 LineNode
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 LineNode e non della stringa riconosciuta dell'intero oggetto LineNode o RootNode.

I parametri start e length sono riferimenti perché è possibile modificare i relativi valori. Se ad esempio il valore restituito di GetRecognizedString è "I am late" e si passano valori dei parametri start = 6 e length = 1, corrispondenti alla lettera "a", è 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 verrà modificato in 5 e il valore di length 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 definiscono l'intervallo di testo per la parola "late".

Esempi

Nell'esempio seguente viene utilizzato un oggetto ContextNodeCollection, lastWordCollection, che contiene un oggetto ContextNode corrispondente all'ultima parola in LineNode, line. Tutti gli oggetti Strokes vengono quindi contrassegnati in nero, ad eccezione di quelli che corrispondono al testo selezionato nell'ultima riga, che vengono visualizzati in rosso.

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

' Set all strokes to black
Dim stroke As Stroke
For Each stroke In line.Strokes
    stroke.DrawingAttributes = New DrawingAttributes(Color.Black)
Next

' Set strokes in the collection to red
Dim node As ContextNode
For Each node In selectedNodes
    For Each stroke In node.Strokes
        stroke.DrawingAttributes = New DrawingAttributes(Color.Red)
    Next
Next

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

// Set all strokes to black
foreach (Stroke stroke in line.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.