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

아티클
08/26/2023

이 범위의 텍스트를 설정합니다.

구문

HRESULT SetText(
  [in] BSTR bstr
);

매개 변수

[in] bstr

형식: BSTR

이 범위의 현재 텍스트를 바꾸는 텍스트입니다. null이면 현재 텍스트가 삭제됩니다.

반환 값

형식: HRESULT

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

반환 코드	Description
E_ACCESSDENIED	텍스트는 쓰기로 보호됩니다.
E_INVALIDARG	bstr이 null입니다.
E_OUTOFMEMORY	메모리가 부족합니다.

설명

ITextRange::SetText 는 범위의 텍스트를 새 텍스트로 바꿉니다. 반면 , TypeText 는 선택 영역을 텍스트 bstr 로 바꾸고 텍스트를 입력한 것처럼 삽입된 텍스트 바로 뒤에 있는 삽입 지점으로 선택 영역을 그대로 둡니다. UI 선택 동작은 TypeText를 참조하세요.

ITextRange::SetText를 호출한 후 ITextRange::GetText를 호출하면 ITextRange::SetText 메서드를 사용하여 설정한 것과 동일한 텍스트를 다시 가져옵니다(다른 범위가 호출 사이에 해당 텍스트를 변경하지 않는 한).

요구 사항


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