ITextStoreAnchor::QueryInsert 메서드(textstor.h)
ITextStoreAnchor::QueryInsert 메서드는 지정된 시작 및 끝 앵커가 유효한지 여부를 결정합니다. 편집을 실행하기 전에 이 메서드를 사용하여 문서에 대한 편집을 조정합니다. 메서드는 문서 범위를 벗어나는 값을 반환해서는 안 됩니다.
구문
HRESULT QueryInsert(
[in] IAnchor *paTestStart,
[in] IAnchor *paTestEnd,
[in] ULONG cch,
[out] IAnchor **ppaResultStart,
[out] IAnchor **ppaResultEnd
);
매개 변수
[in] paTestStart
삽입된 텍스트의 시작 앵커에 대한 포인터를 받습니다.
[in] paTestEnd
삽입된 텍스트의 끝 앵커에 대한 포인터를 받습니다. 선택한 텍스트를 바꾸는 대신 한 지점에서 텍스트를 삽입하는 경우 paTestStart 와 동일합니다.
[in] cch
대체 텍스트의 길이입니다.
[out] ppaResultStart
삽입된 텍스트의 시작 위치에 있는 새 앵커 개체에 대한 포인터입니다. 이 매개 변수의 값이 NULL이면 지정된 위치에 텍스트를 삽입할 수 없습니다. 이 앵커는 문서 외부에 있을 수 없습니다.
[out] ppaResultEnd
삽입된 텍스트의 끝 위치에 있는 새 앵커 개체에 대한 포인터입니다. 이 매개 변수의 값이 NULL이면 지정된 위치에 텍스트를 삽입할 수 없습니다. 이 앵커는 문서 외부에 있을 수 없습니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
값 | Description |
---|---|
|
메서드를 성공적으로 수행했습니다. |
|
지정되지 않은 오류가 발생했습니다. |
|
paTestStart 또는 paTestEnd 매개 변수가 잘못되었습니다. |
|
ppaResultStart 및/또는 ppaResultEnd 앵커를 인스턴스화하지 못했습니다. |
설명
ppaResultStart 및 ppaResultEnd 값은 애플리케이션이 문서에 텍스트를 삽입하는 방법에 따라 달라집니다. ppaResultStart 및 ppaResultEnd가 paTestStart와 동일한 경우 커서는 삽입 후 삽입된 텍스트의 시작 부분에 있습니다. ppaResultStart 및 ppaResultEnd가 paTextEnd와 동일한 경우 커서는 삽입 후 삽입된 텍스트의 끝에 있습니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱 | UWP 앱] |
지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱 | UWP 앱] |
대상 플랫폼 | Windows |
헤더 | textstor.h |
DLL | Msctf.dll |
재배포 가능 파일 | Windows 2000 Professional의 TSF 1.0 |