子孫ノードのコレクション内の認識された文字列の指定したテキスト範囲から取得された子孫 ContextNode オブジェクトのコレクションを返します。
名前空間 : System.Windows.Ink
アセンブリ : IAWinFX (IAWinFX.dll 内)
構文
'宣言
Public Function GetNodesFromTextRange ( _
ByRef start As Integer, _
ByRef length As Integer, _
subTree As ContextNodeCollection _
) As ContextNodeCollection
'使用
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
パラメータ
- start
型 : System.Int32%
- length
型 : System.Int32%
- subTree
型 : System.Windows.Ink.ContextNodeCollection
検索範囲を絞るために使用する子孫 ContextNode オブジェクト。
戻り値
型 : System.Windows.Ink.ContextNodeCollection
認識された文字列の指定したテキスト範囲から取得された子孫 ContextNode オブジェクトのコレクション。ノードは、subTree の子孫に限定されます。
解説
start パラメータと length パラメータは、返された ContextNodeCollection と関連付けられた文字列全体を指定するように変更できる参照値です。たとえば、GetRecognizedString の戻り値が "I am late" で、start = 6 および length = 1 という値を渡すと、このパラメータは文字 "a" に対応します。この場合、ContextNodeCollection の ContextNode は 1 つのみとなる可能性が高くなります ("late" という語に対応する InkWordNode)。この場合、start の値は 5 に、length の値は 4 に変更されます ("late" という語全体に対応)。
メモ start パラメータは、WritingRegionNode 全体または RootNode 全体の認識された文字列ではなく、この WritingRegionNode の認識された文字列の subTree 部分のノードに関連しています。前の例では、"am" および "late" のノードを持つが、"I" のノードは持たない subTree パラメータを渡した場合、start パラメータが 3 で長さが 4 の場合は、"late" という語のテキスト範囲です。
例
次の例では、ContextNodeCollection、lastParagraphLevelCollection を取得します。このコレクションには、writingRegion という名前のWritingRegion の最後の段落に対応する 1 つの ContextNode が含まれます。ここでは、最後の段落は赤色に、それ以外のすべての Strokes が黒色でマークされます。
' Get the nodes that correspond to this start and length
Dim selectedNodes As ContextNodeCollection = writingRegion.GetNodesFromTextRange(start, length, lastParagraphCollection)
' Set all strokes to black
For Each stroke As Stroke In writingRegion.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 =
writingRegion.GetNodesFromTextRange(ref start, ref length, lastParagraphCollection);
// Set all strokes to black
foreach (Stroke stroke in writingRegion.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;
}
}
プラットフォーム
Windows Vista
.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。
バージョン情報
.NET Framework
サポート対象 : 3.0