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

아티클
08/26/2023

범위의 시작 위치에 있는 문자를 가져옵니다.

구문

HRESULT GetChar(
  long *pChar
);

매개 변수

pChar

형식: long*

범위의 시작 문자 위치입니다.

반환 값

형식: HRESULT

메서드는 HRESULT 값을 반환합니다. 메서드가 성공하면 S_OK 반환합니다. pChar가 null이면 메서드가 실패하고 E_INVALIDARG 반환합니다.

설명

다음 Microsoft Visual Basic 예제에서는 ch 를 범위의 시작 부분에 있는 문자와 동일하게 설정합니다.

ch = r.Char

마찬가지로 ITextRange::SetChar 는 범위의 시작 부분에 있는 문자를 지정된 문자로 덮어씁니다. 이러한 메서드에서 검색하고 설정하는 문자는 LONG 변수로, 백업 저장소에 저장되는 방식(바이트, 단어, 가변 길이 등)을 숨기고 BSTR을 사용할 필요가 없습니다.

문자 컬렉션에서 수행할 수 있는 대부분의 작업을 수행할 수 있는 Char 속성은 두 가지 큰 장점이 있습니다.

부모 범위로 제한되는 대신 부모 스토리의 모든 문자를 참조할 수 있습니다.
LONG은 범위 개체 대신 관련되므로 훨씬 빠릅니다.

따라서 TOM(텍스트 개체 모델)은 문자 컬렉션을 지원하지 않습니다.

요구 사항


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