ITextRange::StartOf 메서드(tom.h)

아티클
03/03/2024

범위 끝을 범위의 첫 번째 겹치는 단위 의 시작으로 이동합니다.

구문

HRESULT StartOf(
  long Unit,
  long Extend,
  long *pDelta
);

매개 변수

Unit

형식: long

이동 작업에 사용할 단위입니다. 단위 값 목록은 ITextRange 아래의 토론을 참조하세요.

Extend

형식: long

범위의 끝을 이동하는 방법입니다. 다음 값 중 하나일 수 있습니다.

0(또는 tomMove)	삽입 지점을 이동하여 비일반 범위를 시작 위치로 축소합니다. 이것이 기본값입니다.
1(또는 tomExtend)	시작 위치를 겹치는 단위의 시작 부분으로 이동합니다. 끝 위치를 이동하지 않습니다.

pDelta

형식: long*

시작 위치가 이동되는 문자 수를 받는 변수에 대한 포인터입니다. null일 수 있습니다. 반환 시 pDelta 는 삽입 지점 또는 시작 위치가 이동되는 서명된 문자 수입니다. 동작이 항상 스토리의 시작 부분에 있기 때문에 이 값은 항상 0보다 작거나 같습니다.

반환 값

형식: HRESULT

메서드는 HRESULT 값을 반환합니다. 메서드가 성공하면 S_OK 반환합니다. 메서드가 실패하면 다음 오류 코드 중 하나를 반환합니다. COM 오류 코드에 대한 자세한 내용은 COM에서 오류 처리를 참조하세요.

반환 코드	설명
E_NOTIMPL	단위는 지원되지 않습니다.
S_FALSE	다른 이유로 인해 실패합니다.

설명

범위가 단위사이의 경계에 있는 삽입 지점인 경우 ITextRange::StartOf 는 시작 위치를 변경하지 않습니다.

ITextRange::StartOf 및 ITextRange::EndOf 메서드는 후자가 활성 끝에서 확장된다는 점에서 HomeKey 및 EndKey 메서드와 다르지만 ITextRange::StartOf는 시작 위치에서 확장되고 ITextRange::EndOf는 끝 위치에서 확장됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	tom.h
DLL	Msftedit.dll