ITextSelection::HomeKey 메서드(tom.h)

아티클
03/03/2024

홈 키의 기능을 일반화합니다.

구문

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

매개 변수

Unit

형식: long

홈 키 작업에서 사용할 단위입니다. 다음 값 중 하나를 사용할 수 있습니다.

값	의미
tomLine	Extend에 따라 삽입 지점 또는 활성 끝을 선택 영역의 첫 번째 줄의 시작 부분으로 이동합니다. 이것이 기본값입니다.
tomStory	Extend에 따라 삽입 지점 또는 활성 끝을 스토리의 첫 번째 줄의 시작 부분으로 이동합니다.
tomColumn	확장에 따라 삽입 지점 또는 활성 끝을 선택 영역의 첫 번째 열의 시작 부분으로 이동합니다. TOM 엔진이 테이블을 지원하는 경우에만 사용할 수 있습니다.
tomRow	Extend에 따라 삽입 지점 또는 활성 끝을 선택 영역의 첫 번째 행의 시작 부분으로 이동합니다. TOM 엔진이 테이블을 지원하는 경우에만 사용할 수 있습니다.

Extend

형식: long

선택 영역을 변경하는 방법을 나타내는 플래그입니다. Extend가 0(또는 tomMove)이면 메서드는 선택 영역을 삽입 지점으로 축소합니다. Extend가 1(또는 tomExtend)인 경우 메서드는 활성 끝을 이동하고 다른 쪽 끝을 단독으로 둡니다. 기본값은 영입니다.

pDelta

형식: long*

삽입 지점 또는 활성 끝이 이동되는 문자 수를 받는 변수에 대한 포인터입니다. 이 매개 변수는 null일 수 있습니다.

반환 값

형식: HRESULT

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

반환 코드	설명
E_INVALIDARG	단위는 tomLine이나 tomStory가 아닙니다.
S_FALSE	다른 이유로 인해 실패합니다.

설명

ITextSelection::HomeKey 및 ITextSelection::EndKey 메서드는 표준 홈/엔드 키 동작을 모방하는 데 사용됩니다.

tomLine 은 Ctrl 키를 누르 지 않고 홈 또는 끝 키 동작을 모방하고 tomStory 는 Ctrl 키를 누른 상태에서 동작을 모방합니다. 마찬가지로 tomMove 는 Shift 키를 누르 지 않고 홈 또는 끝 키 동작을 모방하고 tomExtend 는 Shift 키를 누른 상태에서 동작을 모방합니다. 따라서 HomeKey(tomStory) 선택 영역을 연결된 스토리의 시작 부분에 있는 삽입 지점으로 변환하고 HomeKey(tomStory, tomExtend)는 선택 영역의 활성 끝을 스토리의 시작 부분으로 이동하고 다른 쪽 끝을 그대로 둡니다.

HomeKey 및 EndKey 메서드는 방향 메서드가 아닌 Move 메서드와 같은 논리적 메서드입니다. 따라서 관련된 언어에 따라 달라집니다. 예를 들어 아랍어 텍스트에서 HomeKey 는 줄의 오른쪽 끝으로 이동하는 반면 영어 텍스트에서는 왼쪽으로 이동합니다. 따라서 HomeKey 및 EndKey 메서드는 ITextSelection::MoveLeft 및 ITextSelection::MoveRight 메서드와 다릅니다. 또한 HomeKey 메서드는 선택 영역의 시작 부분에 있는 cp인 Start 속성과 매우 다릅니다. HomeKey 및 EndKey 는 활성 끝에서 확장된다는 점에서 StartOf 및 EndOf 메서드와는 다른 반면 StartOf 는 Start 및 EndOf 에서 확장되어 End에서 확장됩니다.

요구 사항

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