ITextRangeProvider::MoveEndpointByUnit 메서드(uiautomationcore.h)
텍스트 범위의 한 엔드포인트를 문서 범위 내에서 지정한 수의 TextUnit 단위로 이동합니다.
통사론
HRESULT MoveEndpointByUnit(
[in] TextPatternRangeEndpoint endpoint,
[in] TextUnit unit,
[in] int count,
[out, retval] int *pRetVal
);
매개 변수
[in] endpoint
형식: TextPatternRangeEndpoint
이동할 엔드포인트입니다.
[in] unit
형식: textUnit
문자, 단어, 단락 등과 같은 텍스트 단위의 형식입니다.
[in] count
형식: int
이동할 단위 수입니다. 양수 값은 엔드포인트를 앞으로 이동합니다. 음수 값은 뒤로 이동합니다. 값이 0이면 아무 효과가 없습니다.
[out, retval] pRetVal
형식: int*
실제로 이동된 단위 수를 받습니다. 엔드포인트를 문서 시작 또는 끝으로 이동하는 경우 요청된 수보다 작을 수 있습니다.
반환 값
형식: HRESULT
이 메서드가 성공하면 S_OK반환됩니다. 그렇지 않으면 HRESULT 오류 코드를 반환합니다.
발언
엔드포인트 지정된 대로 다음 사용 가능한 단위 경계로 앞으로 또는 뒤로 이동합니다. 원래 엔드포인트 지정된 텍스트 단위의 경계에 있는 경우 다음 그림과 같이 엔드포인트 사용 가능한 다음 텍스트 단위 경계로 이동합니다.
이동 중인 엔드포인트 동일한 텍스트 범위의 다른 엔드포인트 교차하는 경우 다른 엔드포인트 이동되어 퇴행 범위가 생성되고 엔드포인트 올바른 순서를 보장합니다(즉, 시작이 항상 끝보다 작거나 같음).
ITextRangeProvider::MoveEndpointByUnit 지정된 텍스트 단위가 컨트롤에서 지원되지 않는 경우 지원되는 다음 텍스트 단위까지 사용되지 않습니다.
가장 작은 단위에서 가장 큰 단위로 순서가 여기에 나열됩니다.
- 문자
- 서식
- word
- 줄
- 단락
- 페이지
- 문서
단위TextUnit::Format 경우 범위 동작
TextUnit::Format
단위로 값은 텍스트 범위의 경계를 배치하여 범위 내에서 텍스트의 공유 텍스트 특성(형식)에 따라 범위를 확장하거나 이동합니다. 그러나 서식 텍스트 단위를 사용하면 이미지 또는 하이퍼링크와 같은 포함된 개체의 경계를 넘어 텍스트 범위를 이동하거나 확장해서는 안 됩니다. 자세한 내용은 요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | uiautomationcore.h(UIAutomation.h 포함) |
참고 항목
개념
ITextProvider
ITextRangeProvider
참조
텍스트 및 TextRange 컨트롤 패턴