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
S_OK	메서드를 성공적으로 수행했습니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.
E_INVALIDARG	paTestStart 또는 paTestEnd 매개 변수가 잘못되었습니다.
E_OUTOFMEMORY	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