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

ITextStoreACP::InsertEmbeddedAtSelection 메서드는 삽입 지점 또는 선택 영역에 IDataObject 개체를 삽입합니다. 이 메서드를 호출하는 클라이언트에는 IDataObject 개체를 문서에 삽입하기 전에 읽기/쓰기 잠금이 있어야 합니다.

구문

HRESULT InsertEmbeddedAtSelection(
  [in]  DWORD         dwFlags,
  [in]  IDataObject   *pDataObject,
  [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] pDataObject

삽입할 IDataObject 개체에 대한 포인터입니다.

[out] pacpStart

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

[out] pacpEnd

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

[out] pChange

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

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

반환 값

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

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

설명

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

요구 사항

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

추가 정보

Idataobject

ITextStoreACP

TF_IAS_* 상수

TS_TEXTCHANGE