ITfInsertAtSelection::InsertEmbeddedAtSelection 메서드(msctf.h)
ITfInsertAtSelection::InsertEmbeddedAtSelection 메서드는 선택 영역 또는 삽입 지점에 IDataObject 개체를 삽입합니다.
구문
HRESULT InsertEmbeddedAtSelection(
[in] TfEditCookie ec,
[in] DWORD dwFlags,
[in] IDataObject *pDataObject,
[out] ITfRange **ppRange
);
매개 변수
[in] ec
편집 컨텍스트를 식별합니다. ITfDocumentMgr::CreateContext 또는 ITfEditSession::D oEditSession에서 가져옵니다.
[in] dwFlags
다음 값 중 하나가 있는 비트 필드:
TF_IAS_NOQUERY
ppRange 매개 변수는 종료할 때 NULL입니다.
TF_IAS_QUERYONLY
컨텍스트는 수정되지 않지만 ppRange 매개 변수는 삽입이 발생한 것처럼 설정됩니다. 읽기 전용 액세스로 충분합니다. 이 플래그를 설정하지 않으면 ec 매개 변수에 읽기/쓰기 권한이 있어야 합니다.
TF_IAS_NO_DEFAULT_COMPOSITION
컴퍼지션이 필요한 경우 TSF 관리자는 기본 컴퍼지션을 만들지 않습니다. 호출자는 컨텍스트 잠금을 해제하기 전에 삽입된 텍스트를 포함하는 컴퍼지션 개체를 만들어야 합니다.
[in] pDataObject
삽입할 개체에 대한 포인터입니다.
[out] ppRange
삽입된 개체의 위치입니다. (선택 사항)
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 값 | Description |
|---|---|
|
메서드를 성공적으로 수행했습니다. |
|
ec 매개 변수가 잘못된 편집 쿠키입니다. |
|
컨텍스트 개체가 문서 스택에 없습니다. |
|
컨텍스트에 선택 항목이 없습니다. |
|
선택 영역은 읽기 전용입니다. |
|
컨텍스트 소유자는 pDataObject 매개 변수에서 제공하는 형식의 개체를 처리할 수 없습니다. |
설명
호출자는 ITfQueryEmbedded::QueryInsertEmbedded 메서드를 사용하여 이 메서드에서 특정 개체 형식을 수락할 가능성이 있는지 확인할 수 있습니다.
IDataObject 개체 대신 텍스트를 삽입하려면 ITfInsertAtSelection::InsertTextAtSelection 메서드를 사용합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | msctf.h |
| DLL | Msctf.dll |
| 재배포 가능 파일 | Windows 2000 Professional의 TSF 1.0 |
참고 항목
ITfEditSession::D oEditSession