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

Articolo
10/29/2008

Aggiornamento: novembre 2007

Restituisce un insieme di oggetti ContextNode discendenti che derivano dall'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 WritingRegionNode
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 sui quali restringere la ricerca.

Valore restituito

Tipo: Microsoft.Ink.ContextNodeCollection
Insieme di oggetti ContextNode discendenti che derivano dall'intervallo di testo specificato nella stringa riconosciuta. I nodi vengono limitati ai discendenti di subTree.

Note

I parametri start e length sono riferimenti perché è possibile modificare i relativi valori. Se il valore restituito dell'oggetto GetRecognizedString è "I am late" e si passano valori del parametro start = 6 e del parametro length = 1 che corrispondono alla lettera "a", è probabile che l'oggetto 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 nella parte subTree della stringa riconosciuta di questo oggetto WritingRegionNode, anziché della stringa riconosciuta dell'intero oggetto WritingRegionNode o di tutto l'oggetto RootNode. 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, lastParagraphLevelCollection che contiene un oggetto ContextNode che corrisponde all'ultimo paragrafo di un oggetto WritingRegionNode, writingRegion. Tutti gli oggetti Strokes vengono quindi contrassegnati in nero tranne quelli dell'ultimo paragrafo, che vengono visualizzati in rosso.

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

' Set all strokes to black
Dim inkStroke As Stroke
For Each inkStroke In writingRegion.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 =
                    writingRegion.GetNodesFromTextRange(ref start, ref length, lastParagraphCollection);

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