다음을 통해 공유

ITextRange.Text 속성

  • 참조

정의

네임스페이스:
Microsoft.UI.Text
편집

텍스트 범위의 일반 텍스트를 가져오거나 설정합니다.

public:
 property Platform::String ^ Text { Platform::String ^ get(); void set(Platform::String ^ value); };
winrt::hstring Text();

void Text(winrt::hstring value);
public string Text { get; set; }
var string = iTextRange.text;
iTextRange.text = string;
Public Property Text As String

속성 값

String

Platform::String

winrt::hstring

일반 텍스트입니다.

설명

Text 속성은 ITextRange의 기본 속성입니다. 따라서 텍스트 범위에 대해 자동으로 호출됩니다. 예: 아래 예제 중 일부는 이 사실을 사용합니다. print range

Text 메서드는 범위 텍스트의 문자열을 대체합니다. 단일 문자를 처리하기 위해 ITextRange.Character 속성은 Text 속성보다 더 효율적이며 문자를 저장하기 위해 단일 문자 범위를 만들 필요가 없습니다.

범위가 퇴화되면 Text 속성을 사용하면 텍스트를 쉽게 삽입할 수 있습니다. 범위에서 텍스트를 삭제할 수도 있습니다.range.delete range = ""

Text 속성을 사용하면 한 범위를 다른 위치와 동일하게 설정하기만 하면 일반 텍스트를 한 곳에서 다른 위치로 복사할 수 있습니다. 다음 문은 한 범위의 텍스트를 다른 범위의 텍스트로 설정합니다.range1 = range2

이러한 범위는 서로 다른 스토리 또는 다른 앱에 있을 수 있습니다. 그러나 텍스트를 먼저 문자열로 복사한 다음 해당 문자열에서 대상 위치로 복사하는 것을 의미합니다.

대량의 텍스트의 경우 원본에서 대상으로 직접 복사를 수행하고 원본 및 대상에서 지원하는 모든 형식으로 복사를 수행할 수 있으므로 ITextRange.Copy 및 ITextRange.Paste 메서드가 더 빠를 수 있습니다.

Text 속성에서 반환된 텍스트는 유니코드로 제공됩니다. 단락 끝 표시는 원본 파일에 따라 다음 중 하나에 의해 지정될 수 있습니다.

  • 0x2029(유니코드 단락 구분 기호)
  • CRLF(캐리지 리턴/줄 바꿈)(0xd, 0xa)
  • CR 단독으로(0xd)

포함된 개체의 자리 표시자는 공식 유니코드 값이 0xFFFC 특수 문자인 WCH_EMBEDDING 의해 제공됩니다.

적용 대상