ITfRange::CompareStart 메서드(msctf.h)

ITfRange::CompareStart 메서드는 이 텍스트 범위의 시작 앵커 위치를 다른 범위의 앵커와 비교합니다.

구문

HRESULT CompareStart(
  [in]  TfEditCookie ec,
  [in]  ITfRange     *pWith,
  [in]  TfAnchor     aPos,
  [out] LONG         *plResult
);

[in] ec

[in] pWith

앵커를 이 범위 시작 앵커와 비교할 지정된 범위에 대한 포인터입니다.

[in] aPos

이 범위 시작 앵커와 비교할 지정된 pWith 범위의 앵커를 나타내는 열거형 요소입니다.

값	의미
TF_ANCHOR_START	이 범위 시작 앵커와 지정된 범위 시작 앵커를 비교합니다.
TF_ANCHOR_END	이 범위 시작 앵커를 지정된 범위 끝 앵커와 비교합니다.

[out] plResult

이 범위 시작 앵커와 지정된 pWith 범위 앵커 간의 비교 결과에 대한 포인터입니다.

값	의미
-1	이 시작 앵커는 지정된 범위의 앵커 뒤에 있습니다(지정된 범위의 앵커에 대한 이 시작 앵커 < 위치의 위치).
0	이 시작 앵커는 지정된 범위의 앵커와 동일한 위치에 있습니다.
+1	이 시작 앵커는 지정된 범위의 앵커 앞에 있습니다(지정된 범위의 앵커에 대한 이 시작 앵커 > 위치의 위치).

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

값	Description
S_OK	메서드를 성공적으로 수행했습니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.
E_INVALIDARG	하나 이상의 매개 변수가 잘못되었습니다.
TF_E_NOLOCK	ec 매개 변수의 값이 잘못된 쿠키이거나 호출자에게 읽기 전용 잠금이 없습니다.

두 앵커가 단일 지역에 있지 않으면 이 메서드는 0을 반환하지 않습니다. 호출자에게 두 앵커가 동일한 위치에 배치되는지 여부에 대한 정보만 필요한 경우 ITfRange::IsEqualStart 가 더 효율적입니다.


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