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

아티클
08/26/2023

End 키의 기능을 모방합니다.

구문

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

매개 변수

Unit

형식: long

사용할 단위입니다. 다음 중 하나일 수 있습니다.

값	의미
tomLine	Extend에 따라 삽입 지점 또는 활성 끝을 선택 영역의 마지막 줄 끝으로 이동합니다. 이것이 기본값입니다.
tomStory	Extend에 따라 삽입 지점 또는 활성 끝을 스토리의 마지막 줄 끝으로 이동합니다.
tomColumn	Extend에 따라 삽입 지점 또는 활성 끝을 선택 영역의 마지막 열 끝으로 이동합니다. 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	다른 이유로 인해 실패합니다.

설명

Extend를 tomExtend(또는 0이 아닌 값)로 설정하면 누를 Shift 키에 해당합니다. 단위를 tomLine으로 설정하면 Ctrl 키를 누르지 않는 것에 해당합니다. 단위를 tomStory로 설정하여 누르고 있는 Ctrl로 설정합니다. pDelta 매개 변수는 삽입 지점 또는 활성 끝이 이동되는 문자 수를 받습니다.

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

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

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

요구 사항


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