ITextRangeProvider::MoveEndpointByUnit 메서드(uiautomationcore.h)
텍스트 범위의 한 엔드포인트를 문서 범위 내에서 지정된 수의 TextUnit 단위로 이동합니다.
구문
HRESULT MoveEndpointByUnit(
TextPatternRangeEndpoint endpoint,
TextUnit unit,
[in] int count,
[out, retval] int *pRetVal
);
매개 변수
endpoint
unit
[in] count
형식: int
이동할 단위 수입니다. 양수 값을 사용하면 엔드포인트이 앞으로 이동합니다. 음수 값을 사용하면 뒤로 이동합니다. 0은 효과가 없습니다.
[out, retval] pRetVal
형식: int*
실제로 이동한 단위 수를 받습니다. 엔드포인트 이동이 문서의 시작 또는 끝으로 실행되는 경우 요청된 수보다 작을 수 있습니다.
반환 값
형식: HRESULT
메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
엔드포인트는 지정된 대로 다음 사용 가능한 단위 경계로 앞으로 또는 뒤로 이동합니다. 원래 엔드포인트 가 지정된 텍스트 단위의 경계에 있는 경우 다음 그림과 같이 엔드포인트 가 사용 가능한 다음 텍스트 단위 경계로 이동됩니다.
이동 중인 엔드포인트 가 동일한 텍스트 범위의 다른 엔드포인트 와 교차하는 경우 다른 엔드포인트 도 이동되므로 범위가 퇴화되고 엔드포인트 의 올바른 순서가 보장됩니다(즉, 시작이 항상 끝보다 작거나 같음).ITextRangeProvider::MoveEndpointByUnit 은 지정된 텍스트 단위가 컨트롤에서 지원되지 않는 경우 지원되는 다음 텍스트 단위까지 더 이상 사용되지 않습니다.
가장 작은 단위에서 가장 큰 단위로 순서가 여기에 나열됩니다.
- 문자
- 형식
- Word
- 선
- Paragraph
- 호출
- Document
단위가 인 경우의 범위 동작TextUnit::Format
TextUnit::Format
단위 값이 텍스트 범위의 경계를 배치하여 범위 내에서 텍스트의 공유 텍스트 특성(형식)에 따라 범위를 확장하거나 이동할 수 있습니다. 그러나 서식 텍스트 단위를 사용하면 이미지 또는 하이퍼링크와 같은 포함된 개체의 경계를 넘어 텍스트 범위를 이동하거나 확장하면 안 됩니다. 자세한 내용은 UI 자동화 텍스트 단위 또는 텍스트 및 TextRange 컨트롤 패턴을 참조하세요.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows XP [데스크톱 앱 | UWP 앱] |
지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱 | UWP 앱] |
대상 플랫폼 | Windows |
헤더 | uiautomationcore.h(UIAutomation.h 포함) |
추가 정보
개념
참조
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기