ITextStoreACP::QueryInsert 메서드(textstor.h)

ITextStoreACP::QueryInsert 메서드는 지정된 시작 및 끝 문자 위치가 유효한지 여부를 결정합니다. 편집을 실행하기 전에 이 메서드를 사용하여 문서에 대한 편집을 조정합니다. 메서드는 문서 범위를 벗어나는 값을 반환해서는 안 됩니다.

구문

HRESULT QueryInsert(
  [in]  LONG  acpTestStart,
  [in]  LONG  acpTestEnd,
  [in]  ULONG cch,
  [out] LONG  *pacpResultStart,
  [out] LONG  *pacpResultEnd
);

매개 변수

[in] acpTestStart

삽입된 텍스트의 시작 애플리케이션 문자 위치입니다.

[in] acpTestEnd

삽입된 텍스트의 끝 애플리케이션 문자 위치입니다. 이 값은 선택한 텍스트를 바꾸는 대신 텍스트가 한 지점에 삽입된 경우 acpTextStart 와 같습니다.

[in] cch

대체 텍스트의 길이입니다.

[out] pacpResultStart

삽입된 텍스트의 새 시작 애플리케이션 문자 위치를 반환합니다. 이 매개 변수가 NULL이면 지정된 위치에 텍스트를 삽입할 수 없습니다. 이 값은 문서 범위를 벗어날 수 없습니다.

[out] pacpResultEnd

삽입된 텍스트의 새 끝 애플리케이션 문자 위치를 반환합니다. 이 매개 변수가 NULL이면 pacpResultStart 가 NULL 로 설정되고 지정된 위치에 텍스트를 삽입할 수 없습니다. 이 값은 문서 범위를 벗어날 수 없습니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

값	Description
S_OK	메서드를 성공적으로 수행했습니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.
E_INVALIDARG	acpTestStart 또는 acpTestEnd 매개 변수가 잘못되었습니다.

설명

pacpResultStart 및 pacpResultEnd의 값은 애플리케이션이 문서에 텍스트를 삽입하는 방법에 따라 달라집니다. pacpResultStart 및 pacpResultEnd가 acpTextStart와 동일한 경우 커서는 삽입 후 삽입된 텍스트의 시작 부분에 있습니다. pacpResultStart 및 pacpResultEnd가 acpTextEnd와 같으면 커서는 삽입 후 삽입된 텍스트의 끝에 있습니다. pacpResultStart와 pacpResultEnd의 차이가 삽입된 텍스트의 길이와 같으면 삽입 후 삽입된 텍스트가 강조 표시됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	textstor.h
DLL	Msctf.dll
재배포 가능 파일	Windows 2000 Professional의 TSF 1.0