ITextSelection::TypeText 메서드(tom.h)

아티클
03/03/2024

이 선택 영역에서 bstr 에서 지정한 문자열을 다른 사람이 입력한 것처럼 입력합니다. 이는 기본 SetText 메서드와 비슷하지만 삽입/덮어쓰기 키 상태 및 자동 고침 및 스마트 따옴표와 같은 UI 설정에 민감합니다.

구문

HRESULT TypeText(
  BSTR bstr
);

매개 변수

bstr

형식: BSTR

이 선택 영역에 입력할 문자열입니다.

반환 값

형식: HRESULT

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

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

설명

이 메서드는 이 선택 영역에서 bstr 에서 지정한 문자열을 다른 사람이 입력한 것처럼 입력합니다. TypeText 사용은 SendMessage 함수를 통해 문자를 보내는 것보다 빠르지만 SetText를 사용하는 것보다 느립니다.

TypeText 는 기본 SetText 메서드와 비슷하게 삽입/덮어쓰기 키 상태 및 자동 고침 및 스마트 따옴표와 같은 UI 설정에 민감합니다. 예를 들어 퇴행되지 않은 선택 영역을 삭제한 다음 삽입 지점의 문자열 bstr(Insert/Overtype 키 상태에 따라 SetFlags 메서드 참조)를 삽입하거나 오버타입하여 삽입된 텍스트 뒤에 삽입 지점으로 남겨 둡니다.

요구 사항

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