TextRange 클래스

정의

네임스페이스:

System.Windows.Documents

어셈블리:

PresentationFramework.dll

두 TextPointer 위치 사이의 콘텐츠 선택을 나타냅니다.

public ref class TextRange

public class TextRange

type TextRange = class

Public Class TextRange

상속

Object

TextRange

파생

System.Windows.Documents.TextSelection

예제

다음 예제에서는 TextRangeText 속성을 사용하여 지정된 FlowDocument일반 텍스트 표현을 반환하는 방법을 보여 줍니다.

// This method returns a plain text representation of a specified FlowDocument.
string GetTextFromFlowDocument(FlowDocument flowDoc)
{
     // Create a new TextRanage that takes the entire FlowDocument as the current selection.
     TextRange flowDocSelection = new TextRange(flowDoc.ContentStart, flowDoc.ContentEnd);
      
     // Use the Text property to extract a string that contains the unformatted text contents 
     // of the FlowDocument.
     return flowDocSelection.Text;
}

' This method returns a plain text representation of a specified FlowDocument.
Private Function GetTextFromFlowDocument(ByVal flowDoc As FlowDocument) As String
    ' Create a new TextRanage that takes the entire FlowDocument as the current selection.
    Dim flowDocSelection As New TextRange(flowDoc.ContentStart, flowDoc.ContentEnd)

    ' Use the Text property to extract a string that contains the unformatted text contents 
    ' of the FlowDocument.
    Return flowDocSelection.Text
End Function

설명

TextRange 클래스에는 다음 용어가 도입됩니다.

• 선택 - TextRangeTextPointers표시된 두 위치 간의 콘텐츠 선택입니다. 이러한 위치 중 하나는 선택 영역과 관련하여 고정 앵커를 배치하고 다른 위치는 이동 가능합니다. 이는 마우스 또는 키보드를 사용하여 사용자가 선택한 항목이 동작하는 방식과 유사합니다.

• 현재 선택 - TextRange 항상 콘텐츠의 선택을 나타내기 때문에 TextRange 표시된 선택 영역을 현재 선택 영역참조하는 것이 좋습니다.

• 텍스트 컨테이너 - 텍스트 컨테이너 현재 흐름 콘텐츠의 최종 테두리를 형성하는 요소입니다. TextRange 표시된 선택 영역은 항상 텍스트 컨테이너에 속합니다. 현재 텍스트 컨테이너는 FlowDocument 또는 TextBlock.

• 문서 - 텍스트 컨테이너 내에 집합적으로 포함된 콘텐츠를 문서이라고 합니다.

위치같은 다른 관련 용어에 대한 자세한 내용은 TextPointer참조하세요.

생성자

TextRange(TextPointer, TextPointer)

지정된 두 TextPointer 위치를 새 범위의 시작 위치와 끝 위치로 사용하여 TextRange 클래스의 새 인스턴스를 초기화합니다.

속성

End	현재 선택 영역의 끝을 표시하는 위치를 가져옵니다.
IsEmpty	현재 선택 영역이 비어 있는지 여부를 나타내는 값을 가져옵니다.
Start	현재 선택 영역의 시작을 표시하는 위치를 가져옵니다.
Text	현재 선택 영역의 일반 텍스트 내용을 가져오거나 설정합니다.

메서드

ApplyPropertyValue(DependencyProperty, Object)	지정된 서식 속성과 값을 현재 선택 영역에 적용합니다.
CanLoad(String)	현재 선택 영역을 지정된 데이터 형식의 콘텐츠와 함께 로드할 수 있는지 여부를 확인합니다.
CanSave(String)	현재 선택 영역을 지정된 데이터 형식으로 저장할 수 있는지 여부를 확인합니다.
ClearAllProperties()	현재 선택 영역에서 모든 서식 속성(Inline 요소로 표시됨)을 제거합니다.
Contains(TextPointer)	TextPointer지정된 위치가 현재 선택 영역 내에 있는지 여부를 확인합니다.
Equals(Object)	지정된 개체가 현재 개체와 같은지 여부를 확인합니다. (다음에서 상속됨 Object)
GetHashCode()	기본 해시 함수로 사용됩니다. (다음에서 상속됨 Object)
GetPropertyValue(DependencyProperty)	현재 선택 영역에서 지정된 서식 속성의 유효 값을 반환합니다.
GetType()	현재 인스턴스의 Type 가져옵니다. (다음에서 상속됨 Object)
Load(Stream, String)	지정된 스트림에서 지정된 데이터 형식으로 현재 선택 영역을 로드합니다.
MemberwiseClone()	현재 Object단순 복사본을 만듭니다. (다음에서 상속됨 Object)
Save(Stream, String, Boolean)	사용자 지정 TextElement 개체를 유지하는 옵션을 사용하여 현재 선택 영역을 지정된 데이터 형식으로 지정된 스트림에 저장합니다.
Save(Stream, String)	현재 선택 영역을 지정된 데이터 형식으로 지정된 스트림에 저장합니다.
Select(TextPointer, TextPointer)	업데이트된 선택 영역을 나타내기 위해 두 TextPointer 위치를 사용하여 현재 선택 영역을 업데이트합니다.
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)

이벤트

Changed

범위가 새 콘텐츠 범위를 포함하도록 위치가 변경될 때 발생합니다.

추가 정보

• TextPointerContext