ITextSelection::MoveRight 메서드(tom.h)
오른쪽 화살표 키의 기능을 일반화합니다.
구문
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에서 오류 처리를 참조하세요.
반환 코드 | 설명 |
---|---|
|
단위가 잘못되었습니다. |
|
다른 이유로 인해 실패합니다. |
설명
CharRight, CharLeft, WordRight 및 WordLeft와 같은 Microsoft WordBasic 이동 메서드는 표준 화살표 키 편집 동작과 밀접하게 관련된 네 가지 작업을 수행할 수 있는 하이브리드입니다.
- 선택 항목이 없으면 현재 삽입 지점을 이동합니다.
- 선택 영역이 있는 경우 선택 영역의 활성 끝을 이동합니다.
- 삽입 지점을 선택 영역으로 바꾸고 그 반대의 경우도 마찬가지입니다.
- 이동이 발생했는지 여부를 나타내는 부울을 반환합니다.
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 |
추가 정보
개념
참조