ITextStoreAnchor::InsertTextAtSelection 메서드(textstor.h)

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

구문

HRESULT InsertTextAtSelection(
  [in]  DWORD       dwFlags,
  [in]  const WCHAR *pchText,
  [in]  ULONG       cch,
  [out] IAnchor     **ppaStart,
  [out] IAnchor     **ppaEnd
);

매개 변수

[in] dwFlags

paStart 및 paEnd 매개 변수에 텍스트 삽입 결과가 포함될지 여부를 지정합니다.

TF_IAS_NOQUERY 및 TF_IAS_QUERYONLY 플래그를 결합할 수 없습니다.

값	의미
TF_IAS_NOQUERY	텍스트가 삽입되고 ppaStart 및 ppaEnd 매개 변수의 값은 NULL일 수 있습니다. 텍스트 삽입 결과가 필요하지 않은 경우 이 플래그를 사용합니다.
TF_IAS_QUERYONLY	텍스트가 삽입되지 않고 ppaStart 및 ppaEnd 앵커에 텍스트 삽입 결과가 포함됩니다. 이러한 매개 변수의 값은 애플리케이션이 문서에 텍스트 삽입을 구현하는 방법에 따라 달라집니다. 실제로 텍스트를 삽입하지 않고 텍스트 삽입 결과를 보려면 이 플래그를 사용합니다. 길이가 0인 텍스트를 삽입할 수 있습니다.

[in] pchText

문서에 삽입할 문자열에 대한 포인터입니다. 문자열은 NULL 종료될 수 있습니다.

[in] cch

텍스트 길이를 지정합니다.

[out] ppaStart

텍스트 삽입의 시작 부분에 있는 앵커 개체에 대한 포인터입니다.

[out] ppaEnd

텍스트 삽입의 끝에 있는 앵커 개체에 대한 포인터입니다. 삽입 지점의 경우 이 매개 변수 값은 ppaStart 매개 변수의 값과 동일합니다.

반환 값

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

값	Description
S_OK	메서드를 성공적으로 수행했습니다.
E_FAIL	메서드가 앵커 paStart 또는 paEnd 중 하나를 인스턴스화할 수 없습니다.
E_INVALIDARG	pchText 매개 변수가 잘못되었습니다.
TS_E_NOLOCK	호출자에게 문서에 대한 잠금이 없습니다.

요구 사항

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

추가 정보

작곡

ITextStoreAnchor

ITextStoreAnchorSink::OnTextChange

TF_IAS_* 상수

TS_TEXTCHANGE