ITextStoreACP2::InsertEmbeddedAtSelection 메서드(textstor.h)
삽입 지점 또는 선택 영역에 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 플래그를 결합할 수 없습니다.
값 | 의미 |
---|---|
|
텍스트 삽입이 발생하고 pacpStart 및 pacpEnd 매개 변수에 텍스트 삽입 결과가 포함됩니다. TS_TEXTCHANGE 구조체는 이 플래그로 채워야 합니다. |
|
텍스트가 삽입되고 pacpStart 및 pacpEnd 매개 변수의 값이 NULL일 수 있으며 TS_TEXTCHANGE 구조체를 채워야 합니다. 텍스트 삽입 결과가 필요하지 않은 경우 이 플래그를 사용합니다. |
|
텍스트가 삽입되지 않고 pacpStart 및 pacpEnd 매개 변수의 값에 텍스트 삽입 결과가 포함됩니다. 이러한 매개 변수의 값은 애플리케이션이 문서에 텍스트 삽입을 구현하는 방법에 따라 달라집니다. 자세한 내용은 주의 섹션을 참조하세요.
예를 들어 텍스트를 실제로 삽입하지 않고 텍스트 삽입 결과를 보려면 이 플래그를 사용하여 선택 영역을 축소하거나 조정한 결과를 예측합니다. TS_TEXTCHANGE 구조를 이 플래그로 채울 필요는 없습니다. |
[in] pDataObject
삽입할 IDataObject 개체에 대한 포인터입니다.
[out] pacpStart
개체 삽입이 발생할 시작 애플리케이션 문자 위치에 대한 포인터입니다.
[out] pacpEnd
개체 삽입이 발생할 끝 애플리케이션 문자 위치에 대한 포인터입니다. 이 매개 변수 값은 삽입 지점에 대한 pacpStart 매개 변수의 값과 동일합니다.
[out] pChange
다음 멤버가 있는 TS_TEXTCHANGE 구조체에 대한 포인터입니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
값 | Description |
---|---|
|
메서드를 성공적으로 수행했습니다. |
|
pchText 매개 변수가 잘못되었습니다. |
|
호출자에게 문서에 대한 잠금이 없습니다. |
설명
pacpStart 및 pacpEnd 매개 변수의 값은 클라이언트 애플리케이션이 개체를 문서에 삽입하는 방법에 따라 달라집니다. 예를 들어 애플리케이션이 개체 삽입 후 개체의 시작 부분에 커서를 설정하는 경우 pacpStart 및 pacpEnd 매개 변수의 값은 TS_TEXTCHANGE 구조체의 acpStart 멤버와 동일합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 8 [데스크톱 앱 | UWP 앱] |
지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱 | UWP 앱] |
대상 플랫폼 | Windows |
헤더 | textstor.h |
DLL | Msctf.dll |