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

아티클
03/02/2024

ITextStoreACP::InsertTextAtSelection 메서드는 삽입 지점 또는 선택 영역에 텍스트를 삽입합니다. 호출자는 텍스트를 삽입하기 전에 문서에 대한 읽기/쓰기 잠금이 있어야 합니다.

구문

HRESULT InsertTextAtSelection(
  [in]  DWORD         dwFlags,
  [in]  const WCHAR   *pchText,
  [in]  ULONG         cch,
  [out] LONG          *pacpStart,
  [out] LONG          *pacpEnd,
  [out] TS_TEXTCHANGE *pChange
);

매개 변수

[in] dwFlags

pacpStart 및 pacpEnd 매개 변수와 TS_TEXTCHANGE 구조체에 텍스트 삽입 결과가 포함되는지 여부를 지정합니다.

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

값	의미
0	텍스트 삽입이 수행되고 pacpStart 및 pacpEnd 매개 변수에 텍스트 삽입 결과가 포함됩니다. TS_TEXTCHANGE 구조체는 이 플래그로 채워야 합니다.
TF_IAS_NOQUERY	텍스트가 삽입되고 pacpStart 및 pacpEnd 매개 변수의 값이 NULL일 수 있으며 TS_TEXTCHANGE 구조체를 채워야 합니다. 텍스트 삽입 결과를 보려면 이 플래그를 사용합니다.
TF_IAS_QUERYONLY	텍스트가 삽입되지 않으며 pacpStart 및 pacpEnd 매개 변수의 값에는 텍스트 삽입 결과가 포함됩니다. 이러한 매개 변수의 값은 애플리케이션이 문서에 텍스트 삽입을 구현하는 방법에 따라 달라집니다. 자세한 내용은 주의 섹션을 참조하세요. 실제로 텍스트를 삽입하지 않고 텍스트 삽입 결과를 보려면 이 플래그를 사용합니다. 이 플래그를 사용하는 경우 TS_TEXTCHANGE 구조를 채울 필요는 없습니다.

[in] pchText

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

[in] cch

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

[out] pacpStart

텍스트 삽입이 발생하는 시작 애플리케이션 문자 위치에 대한 포인터입니다.

[out] pacpEnd

텍스트 삽입이 발생하는 끝 애플리케이션 문자 위치에 대한 포인터입니다. 이 매개 변수 값은 삽입 지점에 대한 pacpStart 매개 변수의 값과 동일합니다.

[out] pChange

다음 멤버가 있는 TS_TEXTCHANGE 구조체에 대한 포인터입니다.

값	의미
acpStart	텍스트가 문서에 삽입되기 전의 시작 애플리케이션 문자 위치입니다.
acpOldEnd	텍스트가 문서에 삽입되기 전의 끝 애플리케이션 문자 위치입니다. 이 값은 삽입 지점의 acpStart 와 동일합니다. 이 값이 acpStart와 다른 경우 텍스트를 삽입하기 전에 텍스트를 선택했습니다.
acpNewEnd	텍스트 삽입 후의 끝 위치입니다.

반환 값

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

값	Description
S_OK	메서드를 성공적으로 수행했습니다.
TS_E_NOLOCK	호출자에게 문서에 대한 잠금이 없습니다.
E_INVALIDARG	pchText 매개 변수가 잘못되었습니다.

설명

pacpStart 및 pacpEnd 매개 변수의 값은 클라이언트 애플리케이션이 문서에 텍스트를 삽입하는 방법에 따라 달라집니다. 예를 들어 애플리케이션이 텍스트 삽입 후 삽입된 텍스트의 시작 부분에 커서를 설정하는 경우 pacpStart 및 pacpEnd 매개 변수의 값은 TS_TEXTCHANGE 구조체의 acpStart 멤버와 동일합니다.

애플리케이션은 이 메서드에 대한 응답으로 ITextStoreACPSink::OnTextChange 메서드를 호출하면 안 됩니다.

요구 사항

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