ITextRange::GetText 메서드(tom.h)

아티클
03/03/2024

이 범위의 일반 텍스트를 가져옵니다. Text 속성은 ITextRange 인터페이스의 기본 속성입니다.

구문

HRESULT GetText(
  BSTR *pbstr
);

매개 변수

pbstr

형식: BSTR*

텍스트입니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK 반환합니다. 메서드가 실패하면 다음 오류 코드 중 하나를 반환합니다. COM 오류 코드에 대한 자세한 내용은 COM에서 오류 처리를 참조하세요.

반환 코드	설명
E_INVALIDARG	pbstr 이 null입니다.
E_OUTOFMEMORY	텍스트를 저장할 메모리가 부족합니다.

설명

ITextRange::GetText 메서드는 범위의 일반 텍스트를 반환합니다. Text 속성은 ITextRange의 기본 속성입니다. 다음 Microsoft Visual Basic for Applications(VBA) 예제와 같이 범위에 대해 자동으로 호출됩니다.

print range

아래 예제 중 일부는 이 사실을 사용합니다. ITextRange::SetText 메서드는 범위 텍스트의 bstr을 대체합니다. 단일 문자를 처리하기 위해 Char 속성은 Text 속성보다 효율적이며 문자를 저장하기 위해 단일 문자 범위를 만들 필요가 없습니다. 범위가 퇴화되면 Text 속성을 사용하면 텍스트를 쉽게 삽입할 수 있습니다. 다음 VBA 예제와 같이 범위에서 텍스트를 삭제할 수도 있습니다.

range.delete

range = ""

Text 속성을 사용하면 한 범위를 다른 범위와 동일하게 설정하기만 하면 일반 텍스트를 한 곳에서 다른 위치로 복사할 수 있습니다. 중복 속성과 는 상당히 다릅니다. 자세한 내용은 ITextRange::GetDuplicate를 참조하세요. 다음 Microsoft Visual Basic 예제 문은 range1의 텍스트를 range2의 텍스트로 설정합니다.

range1 = range2 ' Replace range1's text by range2's

범위는 다른 스토리 또는 다른 애플리케이션에 있을 수 있습니다. 그러나 텍스트를 먼저 BSTR 로 복사한 다음 해당 문자열에서 대상 위치로 복사하는 것을 의미합니다. 대량의 텍스트의 경우 ITextRange::Copy 및 ITextRange::P aste 메서드는 원본에서 대상으로 직접 복사를 수행하고 원본 및 대상에서 지원하는 모든 형식으로 복사를 수행할 수 있으므로 더 빠를 수 있습니다.

Text 속성에서 반환된 텍스트는 유니코드로 제공됩니다. 단락 끝 표시는 원래 파일에 따라 0x2029(유니코드 단락 구분 기호) 또는 캐리지 리턴/줄 바꿈(CR/LF)(0xd, 0xa) 또는 캐리지 리턴만으로 제공될 수 있습니다. Microsoft Word 파일, 클립보드 또는 IDataObject에서 다른 선택을 읽지 않는 한 캐리지 리턴만 사용합니다. 포함된 개체의 자리 표시자는 유니코드 값 이 0xFFFC 특수 문자 WCH_EMBEDDING 의해 지정됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	tom.h
DLL	Msftedit.dll