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

아티클
03/03/2024

오른쪽 화살표 키의 기능을 일반화합니다.

구문

HRESULT MoveRight(
  long Unit,
  long Count,
  long Extend,
  long *pDelta
);

매개 변수

Unit

형식: long

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

값	해당 키 조합	의미
tomCharacter	오른쪽 화살표	한 문자 위치를 오른쪽으로 이동합니다. 이것이 기본값입니다.
tomWord	Ctrl+오른쪽 화살표	한 단어를 오른쪽으로 이동합니다.

Count가 0보다 작으면 이동이 왼쪽에 있습니다.

Count

형식: long

지나갈 단위 수입니다. 기본값은 1입니다. Count가 0보다 작으면 이동이 왼쪽에 있습니다.

Extend

형식: long

선택 영역을 변경하는 방법을 나타내는 플래그입니다. Extend가 0(또는 tomMove)이면 메서드는 선택 영역을 현재 끝의 삽입 지점으로 축소한 다음 이동합니다. Extend가 1(또는 tomExtend)인 경우 메서드는 활성 끝을 이동하고 다른 쪽 끝을 단독으로 둡니다. 기본값은 영입니다. 0이 아닌 Extend 값은 단위에 설명된 키 조합 외에도 누름 중인 Shift 키에 해당 합니다.

pDelta

형식: long*

삽입 지점 또는 활성 끝부분이 왼쪽으로 이동되는 실제 단위 수입니다. 이 매개 변수는 null일 수 있습니다. Extend가 0이면 선택 영역을 축소하면 하나의 단위로 계산됩니다.

반환 값

형식: HRESULT

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

반환 코드	설명
E_INVALIDARG	단위가 잘못되었습니다.
S_FALSE	다른 이유로 인해 실패합니다.

설명

CharRight, CharLeft, WordRight 및 WordLeft와 같은 Microsoft WordBasic 이동 메서드는 표준 화살표 키 편집 동작과 밀접하게 관련된 네 가지 작업을 수행할 수 있는 하이브리드입니다.

선택 항목이 없으면 현재 삽입 지점을 이동합니다.
선택 영역이 있는 경우 선택 영역의 활성 끝을 이동합니다.
삽입 지점을 선택 영역으로 바꾸고 그 반대의 경우도 마찬가지입니다.
이동이 발생했는지 여부를 나타내는 부울을 반환합니다.

MoveLeft 및 MoveRight의 Extend 인수를 사용하면 위의 처음 세 항목과 일치할 수 있으며 pDelta는 네 번째 항목의 일반화입니다. 예를 들어, 단일 범위로 구성된 선택 영역의 경우 다음과 같은 대응이 있습니다(왼쪽에서 오른쪽 문자의 경우).

ITextSelection	Wordbasic	함수
s.MoveRight tomWord, 1, 1	WordRight 1,1	활성 끝 한 단어를 오른쪽으로 이동합니다.
s.MoveLeft tomCharacter, 1, 1	CharLeft 1,1	활성 끝 한 문자를 왼쪽으로 이동합니다.

WordBasic에서와 같이 Count 가 0보다 작으면 왼쪽과 오른쪽의 의미가 서로 바꿔집니다. 이는 MoveLeft (Unit, Count, Extend) 와 같습니다 MoveRight(Unit, -Count, Extend).

WordBasic 및 오른쪽 화살표 키 UI 동작과 마찬가지로, 퇴화 선택 영역에서 를 호출 MoveRight(Unit, Count) 하면 삽입 지점이 지정된 단위 수를 이동합니다. 퇴화 범위에서 가 0보다 큰 경우 를 Count 호출 MoveRight(Unit, Count, 1) 하면 오른쪽 끝이 활성 끝인 범위가 퇴화되지 않습니다.

Extend가 tomExtend(또는 0이 아닌 경우)인 경우 MoveRight는 선택 영역의 활성 끝만 이동하고 다른 쪽 끝은 그대로 둡습니다. 그러나 Extend 가 0과 같고 선택 영역이 0 MoveRight(Unit, Count)Count 보다 큰 경우 선택 영역이 0보다 큰 경우 활성 끝 Count -1 단위를 오른쪽으로 이동한 다음 다른 쪽 끝을 활성 끝으로 이동합니다. 즉, 현재 끝에 삽입 지점을 만듭니다. 범위를 축소하면 하나의 단위로 계산됩니다. MoveRight(tomCharacter) 따라서 은 퇴화되지 않은 선택 영역을 선택 영역의 오른쪽 끝에 있는 퇴화 선택 영역으로 변환합니다. 여기서 Count 의 기본값은 1이고 Extend 의 기본값은 0입니다. 이 예제는 오른쪽 화살표 키를 누르는 데 해당합니다. MoveLeft 및 MoveRight 는 ITextRange 이동 메서드와 관련이 있지만 활성 끝(Shift 키를 눌러 이동한 끝)을 명시적으로 사용한다는 점에서 다릅니다.

요구 사항

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