ITfInsertAtSelection::InsertTextAtSelection 메서드(msctf.h)

선택 영역 또는 삽입 지점에 텍스트를 삽입합니다.

구문

HRESULT InsertTextAtSelection(
  [in]  TfEditCookie ec,
  [in]  DWORD        dwFlags,
  [in]  const WCHAR  *pchText,
  [in]  LONG         cch,
  [out] ITfRange     **ppRange
);

매개 변수

[in] ec

편집 컨텍스트를 식별합니다. ITfDocumentMgr::CreateContext 또는 ITfEditSession::D oEditSession에서 가져옵니다.

[in] dwFlags

다음 값 중 하나가 있는 비트 필드입니다.

값	의미
TF_IAS_NOQUERY	ppRange 는 NULL입니다. 이 플래그는 TF_IAS_QUERYONLY 플래그와 결합할 수 없습니다.
TF_IAS_QUERYONLY	컨텍스트는 수정되지 않지만 ppRange 는 삽입이 발생한 것처럼 설정됩니다. 읽기 전용 액세스로 충분합니다. 이 플래그가 설정되지 않은 경우 ec 는 읽기/쓰기 권한이 있어야 합니다. 이 플래그는 TF_IAS_NOQUERY 플래그와 결합할 수 없습니다.
TF_IAS_NO_DEFAULT_COMPOSITION	컴퍼지션이 필요한 경우 관리자는 기본 컴퍼지션을 만들지 않습니다. 호출자는 컨텍스트 잠금을 해제하기 전에 삽입된 텍스트를 포함하는 컴퍼지션 개체를 만들어야 합니다.

[in] pchText

삽입할 텍스트를 지정합니다.

[in] cch

pchText에서 텍스트의 문자 수를 지정합니다.

[out] ppRange

삽입된 개체의 위치를 받습니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

값	Description
S_OK	메서드를 성공적으로 수행했습니다.
TF_E_NOLOCK	텍스트 서비스에 문서 잠금이 없습니다.
TF_E_DISCONNECTED	컨텍스트 개체가 문서 스택에 없습니다.
TS_E_NOSELECTION	컨텍스트에 선택 항목이 없습니다.
TS_E_READONLY	선택 영역은 읽기 전용입니다.

설명

텍스트 대신 IDataObject 개체를 삽입하려면 ITfInsertAtSelection::InsertEmbeddedAtSelection을 사용합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	msctf.h
DLL	Msctf.dll
재배포 가능 파일	Windows 2000 Professional의 TSF 1.0

추가 정보

Idataobject

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfInsertAtSelection

ITfInsertAtSelection::InsertEmbeddedAtSelection