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

아티클
08/24/2023

범위의 시작 앵커를 이동합니다.

구문

HRESULT ShiftStart(
  [in]  TfEditCookie      ec,
  [in]  LONG              cchReq,
  [out] LONG              *pcch,
  [in]  const TF_HALTCOND *pHalt
);

매개 변수

[in] ec

편집 컨텍스트를 식별하는 편집 쿠키를 포함합니다. ITfDocumentMgr::CreateContext 또는 ITfEditSession::D oEditSession에서 가져옵니다.

[in] cchReq

시작 앵커가 이동되는 문자 수를 포함합니다. 음수 값을 사용하면 앵커가 뒤로 이동하고 양수 값을 사용하면 앵커가 앞으로 이동합니다.

[out] pcch

앵커가 이동된 문자 수를 받는 LONG 값에 대한 포인터입니다.

[in] pHalt

시프트에 대한 조건을 포함하는 TF_HALTCOND 구조체에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.

반환 값

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

값	Description
S_OK	메서드를 성공적으로 수행했습니다.
E_INVALIDARG	하나 이상의 매개 변수가 잘못되었습니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.
TF_E_NOLOCK	ec로 식별된 편집 컨텍스트에는 읽기 전용 잠금이 없습니다.

설명

범위의 시작 및 끝 위치를 앵커라고 합니다.

이 메서드는 지역 경계를 넘어 앵커를 이동할 수 없습니다. 시프트가 지역 경계에 도달하면 실제로 이동된 문자 수가 요청보다 적습니다. ITfRange::ShiftStartRegion 은 앵커를 인접 지역으로 이동하는 데 사용됩니다.

시프트 작업으로 인해 범위 시작 앵커가 끝 앵커를 지나 이동하면 끝 앵커가 시작 앵커와 동일한 위치로 이동됩니다.

ITfRange::ShiftStart 는 긴 작업일 수 있습니다. 성능을 향상시키려면 가능한 경우 ITfRange::ShiftStartToRange 를 사용합니다.

요구 사항


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