IUIAutomationTextRange::Move 메서드(uiautomationclient.h)
텍스트 범위를 지정된 텍스트 단위 수만큼 앞으로 또는 뒤로 이동합니다.
구문
HRESULT Move(
[in] TextUnit unit,
[in] int count,
[out, retval] int *moved
);
매개 변수
[in] unit
형식: TextUnit
문자, 단어, 단락 등의 텍스트 단위 유형을 지정하는 값입니다.
[in] count
형식: int
이동할 텍스트 단위 수입니다. 양수 값은 텍스트 범위를 앞으로 이동합니다. 음수 값은 텍스트 범위를 뒤로 이동합니다. 0은 효과가 없습니다.
[out, retval] moved
형식: int*
실제로 이동한 텍스트 단위 수를 받습니다. 새 텍스트 범위 엔드포인트 중 하나가 IUIAutomationTextPattern::D ocumentRange 메서드에서 검색한 엔드포인트보다 크거나 작은 경우 요청된 수보다 작을 수 있습니다. 탐색이 뒤로 진행되는 경우 이 값은 음수일 수 있습니다.
반환 값
형식: HRESULT
메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
IUIAutomationTextRange::Move 는 텍스트 범위가 텍스트의 다른 부분에 걸쳐 있도록 이동합니다. 어떤 식으로든 텍스트를 변경하지 않습니다.
비일반(비어 있지 않은) 텍스트 범위의 경우 IUIAutomationTextRange::Move 는 다음 단계를 수행하여 범위를 정규화하고 이동합니다.
- 텍스트 범위는 시작 엔드포인트에서 퇴화(비어 있음) 범위로 축소됩니다.
- 필요한 경우 결과 텍스트 범위가 문서의 뒤로 요청된 텍스트 단위 경계의 시작 부분으로 이동합니다.
- 텍스트 범위는 요청된 텍스트 단위 경계 수에 따라 문서에서 앞뒤로 이동합니다.
- 끝 엔드포인트를 요청된 하나의 텍스트 단위 경계로 앞으로 이동하여 텍스트 범위가 퇴화 상태에서 확장됩니다.
퇴화 텍스트 범위의 경우 IUIAutomationTextRange::Move 는 텍스트 삽입 지점을 지정된 텍스트 단위 수만큼 이동하기만 하면됩니다.
텍스트 범위를 이동할 때 IUIAutomationTextRange::Move 는 텍스트에 포함된 개체의 경계를 무시합니다.
IUIAutomationTextRange::Move 는 숨겨진 텍스트와 표시되는 텍스트를 모두 적용합니다.
텍스트 기반 컨트롤이 단위 매개 변수로 지정된 텍스트 단위를 지원하지 않는 경우 IUIAutomationTextRange::Move 는 지원되는 다음 텍스트 단위로 대체합니다.
텍스트 단위의 크기는 가장 작은 단위에서 가장 큰 단위로 다음과 같습니다.
- 문자
- 서식
- Word
- 줄
- Paragraph
- 페이지
- 문서
단위가 인 경우의 범위 동작TextUnit::Format
TextUnit::Format단위 값이 텍스트 범위의 경계를 배치하여 범위 내에서 텍스트의 공유 텍스트 특성(형식)에 따라 범위를 확장하거나 이동할 수 있습니다. 그러나 서식 텍스트 단위를 사용하면 이미지 또는 하이퍼링크와 같은 포함된 개체의 경계를 넘어 텍스트 범위가 이동하거나 확장되지 않습니다. 자세한 내용은 텍스트 단위 UI 자동화 또는 텍스트콘텐츠에 대한 UI 자동화 지원을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트, WINDOWS XP SP3 및 Windows Vista용 플랫폼 업데이트 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트, Windows Server 2003 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | uiautomationclient.h(UIAutomation.h 포함) |