InkAnalyzer.GetNodesFromTextRange メソッド (Int32%, Int32%)
指定したテキスト範囲に関連する ContextNode オブジェクトのコレクションを返します。
名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink.Analysis (Microsoft.Ink.Analysis.dll 内)
構文
'宣言
Public Function GetNodesFromTextRange ( _
ByRef start As Integer, _
ByRef length As Integer _
) As ContextNodeCollection
'使用
Dim instance As InkAnalyzer
Dim start As Integer
Dim length As Integer
Dim returnValue As ContextNodeCollection
returnValue = instance.GetNodesFromTextRange(start, _
length)
public ContextNodeCollection GetNodesFromTextRange(
ref int start,
ref int length
)
public:
ContextNodeCollection^ GetNodesFromTextRange(
int% start,
int% length
)
public ContextNodeCollection GetNodesFromTextRange(
/** @ref */int start,
/** @ref */int length
)
public function GetNodesFromTextRange(
start : int,
length : int
) : ContextNodeCollection
パラメータ
- start
型 : System.Int32%
認識された文字列のテキスト範囲の開始点への参照。
- length
型 : System.Int32%
認識された文字列のテキスト範囲の長さへの参照。
戻り値
型 : Microsoft.Ink.ContextNodeCollection
指定したテキスト範囲に関連する ContextNode オブジェクトのコレクション。
解説
指定されたテキスト範囲は、InkAnalyzer 全体の認識された文字列に関連する必要があります。
このメソッドは、テキスト範囲を最も近い単語境界に拡張することにより、start パラメータおよび length パラメータの値を変更します。
たとえば、認識された文字列が "I am late" の場合に、start にパラメータ値 6 を使用し、length にパラメータ値 1 を使用して ("late" の文字 "a" に対応する) このメソッドを呼び出すと、このメソッドは単一の ContextNode (単語 "late" に対応する InkWordNode または TextWordNode) が含まれているコレクションを返します。この例では、このメソッドはさらに start の値を 5 に変更し、length の値を 4 に変更します (単語 "late" に対応する)。
例
この例では、System.Windows.Forms.TextBox、theResultsTextBox を使用します。この Text プロパティは、既に InkAnalyzer, theInkAnalyzer の GetRecognizedString によって返された値に設定されています。コード例では、テキスト ボックスの選択内容が使用され、その選択内容に対応する Strokes がマークされます。
' Find out what's been selected in the text box
Dim selStart As Integer = theResultsTextBox.SelectionStart
Dim selLength As Integer = theResultsTextBox.SelectionLength
' Get the nodes that correspond to that range
Dim selectedSubNodes As Microsoft.Ink.ContextNodeCollection = _
Me.theInkAnalyzer.GetNodesFromTextRange(selStart, selLength)
' Use the new start and length value to update the
' selection in the TextBox
theResultsTextBox.SelectionStart = selStart
theResultsTextBox.SelectionLength = selLength
' First, set all strokes to black
Dim theStroke As Microsoft.Ink.Stroke
For Each theStroke In Me.theInkAnalyzer.RootNode.Strokes
theStroke.DrawingAttributes = _
New Microsoft.Ink.DrawingAttributes(Color.Black)
Next theStroke
' Next, set all selected sub nodes to red
Dim theContextNode As Microsoft.Ink.ContextNode
For Each theContextNode In selectedSubNodes
For Each theStroke In theContextNode.Strokes
theStroke.DrawingAttributes = _
New Microsoft.Ink.DrawingAttributes(Color.Red)
Next theStroke
Next theContextNode
// Find out what's been selected in the text box
int selStart = theResultsTextBox.SelectionStart;
int selLength = theResultsTextBox.SelectionLength;
// Get the nodes that correspond to that range
Microsoft.Ink.ContextNodeCollection selectedSubNodes =
this.theInkAnalyzer.GetNodesFromTextRange(
ref selStart, ref selLength);
// Use the new start and length value to update the
// selection in the TextBox
theResultsTextBox.SelectionStart = selStart;
theResultsTextBox.SelectionLength = selLength;
// First, set all strokes to black
foreach (Microsoft.Ink.Stroke theStroke
in this.theInkAnalyzer.RootNode.Strokes)
{
theStroke.DrawingAttributes =
new Microsoft.Ink.DrawingAttributes(Color.Black);
}
// Next, set all selected sub nodes to red
foreach (Microsoft.Ink.ContextNode theContextNode in selectedSubNodes)
{
foreach (Microsoft.Ink.Stroke theStroke in theContextNode.Strokes)
{
theStroke.DrawingAttributes =
new Microsoft.Ink.DrawingAttributes(Color.Red);
}
}
プラットフォーム
Windows Vista
.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。
バージョン情報
.NET Framework
サポート対象 : 3.0