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

아티클
03/02/2024

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

구문

HRESULT InsertEmbeddedAtSelection(
  [in]  DWORD       dwFlags,
  [in]  IDataObject *pDataObject,
  [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 앵커에 텍스트 삽입 결과가 포함됩니다. 이러한 매개 변수의 값은 애플리케이션이 문서에 텍스트 삽입을 구현하는 방법에 따라 달라집니다. 예를 들어 실제로 텍스트를 삽입하지 않고 텍스트 삽입 결과를 보려면 이 플래그를 사용하여 선택 영역 축소 또는 조정 결과를 예측합니다.

값

의미

TF_IAS_NOQUERY

텍스트가 삽입되고 ppaStart 및 ppaEnd 매개 변수의 값은 NULL일 수 있습니다. 텍스트 삽입 결과가 필요하지 않은 경우 이 플래그를 사용합니다.

TF_IAS_QUERYONLY

텍스트가 삽입되지 않고 ppaStart 및 ppaEnd 앵커에 텍스트 삽입 결과가 포함됩니다. 이러한 매개 변수의 값은 애플리케이션이 문서에 텍스트 삽입을 구현하는 방법에 따라 달라집니다.

예를 들어 실제로 텍스트를 삽입하지 않고 텍스트 삽입 결과를 보려면 이 플래그를 사용하여 선택 영역 축소 또는 조정 결과를 예측합니다.

[in] pDataObject

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

[out] ppaStart

개체 삽입 시작 시 앵커 개체에 대한 포인터입니다.

[out] ppaEnd

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

반환 값

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

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

설명

TS_CHAR_EMBEDDED 상수를 ITextStoreAnchor::SetText에 전달할 수 없으므로 클라이언트는 이 메서드를 사용하여 텍스트 스트림에 개체를 삽입해야 합니다.

요구 사항

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