ParagraphNode.GetNodesFromTextRange 메서드 (Int32%, Int32%, ContextNodeCollection)
업데이트: 2007년 11월
하위 노드의 컬렉션 내에서 인식된 문자열의 지정된 텍스트 범위와 관련된 하위 ContextNode 개체의 컬렉션을 반환합니다.
네임스페이스: Microsoft.Ink
어셈블리: Microsoft.Ink.Analysis(Microsoft.Ink.Analysis.dll)
구문
‘선언
Public Function GetNodesFromTextRange ( _
ByRef start As Integer, _
ByRef length As Integer, _
subTree As ContextNodeCollection _
) As ContextNodeCollection
‘사용 방법
Dim instance As ParagraphNode
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%
인식된 문자열의 subTree 부분에서 텍스트 범위의 시작 위치입니다.
- length
형식: System.Int32%
인식된 문자열의 텍스트 범위 길이입니다.
- subTree
형식: Microsoft.Ink.ContextNodeCollection
검색을 구체화할 하위 ContextNode 개체입니다.
반환 값
형식: Microsoft.Ink.ContextNodeCollection
하위 노드의 컬렉션 내에서 인식된 문자열의 지정된 텍스트 범위와 관련된 하위 ContextNode 개체의 컬렉션을 반환합니다.
설명
지정된 텍스트 범위의 기준은 전체 ParagraphNode 또는 전체 RootNode의 인식된 문자열이 아닌 이 ParagraphNode의 인식된 문자열 중 subTree 부분이어야 합니다.
start 및 length 매개 변수의 값은 변경될 수 있으므로 이러한 매개 변수는 참조입니다. 예를 들어 GetRecognizedString의 반환 값이 "I am late"인 경우 start 값을 6으로, length 값을 문자 "a"에 해당하는 1로 전달하면 ContextNodeCollection에는 "late"라는 단어에 해당하는 InkWordNode인 ContextNode 하나만 들어 있을 가능성이 높습니다. 이러한 경우 "late"라는 전체 단어에 따라 start의 값이 5로 변경되고 length의 값이 4로 변경됩니다.
참고
start 매개 변수의 기준은 subTree 매개 변수의 노드입니다. 이전 예제에서 "I"가 아닌 "am" 및 "late"에 대한 노드가 포함된 subTree 매개 변수를 전달하는 경우 "late"라는 단어의 텍스트 범위는 start 매개 변수가 3이고 길이가 4입니다.
예제
다음 예제에서는 ParagraphNode인 paragraph의 마지막 줄에 해당하는 ContextNode 개체 하나가 들어 있는 ContextNodeCollection 개체인 lastLineCollection을 사용합니다. 그런 다음 마지막 줄의 선택된 텍스트에 해당하는 Strokes를 빨간색으로 변경하고 나머지 스트로크는 모두 검정색으로 표시합니다.
' Get the nodes that correspond to this start and length
Dim selectedNodes As ContextNodeCollection = paragraph.GetNodesFromTextRange(start, length, lastLineCollection)
' Set all strokes to black
Dim inkStroke As Stroke
For Each inkStroke In paragraph.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 =
paragraph.GetNodesFromTextRange(ref start, ref length, lastLineCollection);
// Set all strokes to black
foreach (Stroke stroke in paragraph.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);
}
}
플랫폼
Windows Vista
.NET Framework 및 .NET Compact Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.
버전 정보
.NET Framework
3.0에서 지원