IUIAutomationTextPattern::RangeFromPoint 메서드(uiautomationclient.h)

지정된 화면 좌표에 가장 가까운 퇴화(빈) 텍스트 범위를 검색합니다.

구문

HRESULT RangeFromPoint(
  [in]          POINT                  pt,
  [out, retval] IUIAutomationTextRange **range
);

[in] pt

형식: POINT

화면 좌표의 위치를 포함하는 구조체입니다.

[out, retval] range

지정된 위치에 가장 가까운 퇴화 텍스트 범위에 대한 포인터를 받습니다.

형식: HRESULT

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

화면 좌표가 이미지, 하이퍼링크, Microsoft Excel 스프레드시트 또는 기타 포함된 개체의 좌표 내에 있는 경우 자식 개체를 래핑하는 텍스트 범위가 반환됩니다.

숨겨진 텍스트는 무시되지 않으므로 이 메서드는 표시된 텍스트에서 지정된 좌표에 가장 가까운 퇴화 범위를 검색합니다.

Windows Internet Explorer 9에서 RangeFromPoint를 구현해도 예상된 결과가 반환되지 않습니다. 대신 클라이언트는 다음을 수행해야 합니다.

GetVisibleRanges 메서드를 호출하여 표시되는 텍스트 범위의 배열을 검색합니다.
배열의 각 텍스트 범위에 대해 IUIAutomationTextRange::GetBoundingRectangles 를 호출하여 경계 사각형을 검색합니다.
경계 사각형을 확인하여 특정 화면 좌표를 차지하는 텍스트 범위를 찾습니다.

요구 사항	값
지원되는 최소 클라이언트	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 포함)