RootNode.GetNodesFromTextRange 메서드 (Int32%, Int32%, ContextNodeCollection)

업데이트: 2007년 11월

하위 노드의 컬렉션에 대해 인식된 문자열의 지정된 텍스트 범위와 관련된 하위 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 RootNode
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 개체의 컬렉션입니다.

설명

start 및 length 매개 변수는 반환된 ContextNodeCollection에 연결된 전체 문자열을 지정하도록 변경될 수 있는 참조 값입니다. 예를 들어 GetRecognizedString의 반환 값이 "I am late"이고 start = 6 및 length = 1의 값을 전달하는 경우 이 매개 변수는 문자 "a"에 해당합니다. 따라서 ContextNodeCollection에는 단어 "late"에 해당하는 InkWordNode라는 ContextNode 하나만 포함될 가능성이 높습니다. 이 예제에서 start의 값은 5로 변경되고 length의 값은 4로 변경("late"라는 전체 단어에 해당)됩니다.

예제

다음 예제에서는 GetNodesFromTextRange 메서드를 사용하여 선택된 텍스트에 해당하는 스트로크를 표시합니다. 예제 코드에서는 이름이 theResultsTextBox인 TextBox의 Text 속성이 GetRecognizedString 메서드에서 반환된 값으로 설정된다고 가정합니다. 또한 예제에서는 사용자가 theResultsTextBox에서 텍스트를 선택했으며 이름이 theInkAnalyzer인 InkAnalyzer가 있다고 가정합니다.

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

    ' Set all strokes to black
    For Each stroke As Stroke In theRootNode.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

End Sub 'showLastWritingRegion_Click

// Get the nodes that correspond to this start and length
ContextNodeCollection selectedNodes =
    theRootNode.GetNodesFromTextRange(ref start, ref length, lastRegionCollection);

// Set all strokes to black
foreach (Stroke stroke in theRootNode.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에서 지원

참고 항목

참조

RootNode 클래스

RootNode 멤버

GetNodesFromTextRange 오버로드

System.Windows.Ink 네임스페이스