ITextStoreACP::InsertTextAtSelection 메서드(textstor.h)
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 플래그를 결합할 수 없습니다.
[in] pchText
문서에 삽입할 문자열에 대한 포인터입니다. 문자열은 NULL 종료될 수 있습니다.
[in] cch
텍스트 길이를 지정합니다.
[out] pacpStart
텍스트 삽입이 발생하는 시작 애플리케이션 문자 위치에 대한 포인터입니다.
[out] pacpEnd
텍스트 삽입이 발생하는 끝 애플리케이션 문자 위치에 대한 포인터입니다. 이 매개 변수 값은 삽입 지점에 대한 pacpStart 매개 변수의 값과 동일합니다.
[out] pChange
다음 멤버가 있는 TS_TEXTCHANGE 구조체에 대한 포인터입니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 값 | Description |
|---|---|
|
메서드를 성공적으로 수행했습니다. |
|
호출자에게 문서에 대한 잠금이 없습니다. |
|
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 |