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 포함)

추가 정보

개념

ITextProvider

ITextRangeProvider

참조

텍스트 및 TextRange 컨트롤 패턴

UI 자동화 공급자 개요