IUIAutomationTextRange::MoveEndpointByUnit 메서드(uiautomationclient.h)

텍스트 범위의 한 엔드포인트을 문서 범위 내에서 지정된 텍스트 단위 수만큼 이동합니다.

구문

HRESULT MoveEndpointByUnit(
  [in]          TextPatternRangeEndpoint endpoint,
  [in]          TextUnit                 unit,
  [in]          int                      count,
  [out, retval] int                      *moved
);

매개 변수

[in] endpoint

형식: TextPatternRangeEndpoint

이동할 엔드포인트(시작 또는 끝)를 지정하는 값입니다.

[in] unit

형식: TextUnit

줄 또는 단락과 같이 이동할 텍스트 단위를 지정하는 값입니다.

[in] count

형식: int

이동할 단위 수입니다. 양수를 사용하면 엔드포인트가 앞으로 이동합니다. 음수를 사용하면 뒤로 이동합니다. 0은 효과가 없습니다.

[out, retval] moved

형식: int*

실제로 이동한 단위 수를 받습니다. 이 값은 엔드포인트 이동이 문서의 시작 또는 끝 부분으로 실행되는 경우 요청된 수보다 작을 수 있습니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

엔드포인트는 지정된 대로 다음 사용 가능한 단위 경계로 앞으로 또는 뒤로 이동합니다. 원래 엔드포인트 가 지정된 텍스트 단위의 경계에 있는 경우 다음 그림과 같이 엔드포인트 가 사용 가능한 다음 텍스트 단위 경계로 이동됩니다.

이동 중인 엔드포인트 가 동일한 텍스트 범위의 다른 엔드포인트 와 교차하는 경우 다른 엔드포인트 도 이동되므로 범위가 퇴화되고 엔드포인트 의 올바른 순서가 보장됩니다(즉, 시작이 항상 끝보다 작거나 같음).

MoveEndpointByUnit 은 지정된 텍스트 단위가 컨트롤에서 지원되지 않는 경우 지원되는 다음 텍스트 단위까지 더 이상 사용되지 않습니다.

가장 작은 단위에서 가장 큰 단위로 순서가 여기에 나열됩니다.

• 문자
• 형식
• Word
• 선
• Paragraph
• 호출
• Document

단위가 인 경우의 범위 동작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 포함)

추가 정보

IUIAutomationTextRange

텍스트 콘텐츠에 대한 UI 자동화 지원