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

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: System.Windows.Ink
Assembly: IAWinFX (in IAWinFX.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%

length
Tipo: System.Int32%

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

Valore restituito

Tipo: System.Windows.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 dall'oggetto LineNode corrente e non alla parte della stringa riconosciuta dall'intero oggetto LineNode o dall'intero oggetto 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 i valori di parametro 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 viene modificato in 5 e il valore di length viene modificato in 4, per corrispondere all'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 di 3 e una lunghezza di 4 sono 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 di un oggetto LineNode, line. Tutti gli oggetti Strokes vengono quindi contrassegnati in nero tranne quelli che corrispondono al testo selezionato nell'ultima riga, che viene visualizzato 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
For Each Stroke As Stroke In line.Strokes
    Stroke.DrawingAttributes.Color = Colors.Black
Next Stroke
' Set strokes in the collection to red
For Each node As ContextNode In selectedNodes
    For Each Stroke As Stroke In node.Strokes
        Stroke.DrawingAttributes.Color = Colors.Red
    Next Stroke
Next node

// 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.Color = Colors.Black;

// Set strokes in the collection to red
foreach (ContextNode node in selectedNodes)
{
    foreach (Stroke stroke in node.Strokes)
    {
        stroke.DrawingAttributes.Color = Colors.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.