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

각 텍스트 범위가 표시되는 텍스트의 연속 범위를 나타내는 텍스트 기반 컨트롤에서 연결이 없는 텍스트 범위의 배열을 검색합니다.

구문

HRESULT GetVisibleRanges(
  [out, retval] IUIAutomationTextRangeArray **ranges
);

매개 변수

[out, retval] ranges

형식: IUIAutomationTextRangeArray**

텍스트 기반 컨트롤 내에서 표시되는 텍스트 범위의 컬렉션에 대한 포인터를 받습니다.

반환 값

형식: HRESULT

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

설명

표시되는 텍스트가 하나의 연속된 텍스트 범위로 구성된 경우 범위 배열에는 표시되는 모든 텍스트를 나타내는 단일 텍스트 범위가 포함됩니다.

표시되는 텍스트가 여러 개의 연결되지 않는 텍스트 범위로 구성된 경우 범위 배열에는 표시되는 각 범위에 대해 하나의 텍스트 범위가 포함되며, 첫 번째 표시 범위부터 시작하여 마지막으로 표시되는 범위로 끝납니다. 텍스트 기반 컨트롤의 콘텐츠가 겹치는 창이나 다른 개체에 의해 부분적으로 가려지거나 여러 페이지 또는 열이 있는 텍스트 기반 컨트롤에 부분적으로 스크롤된 콘텐츠가 있는 경우 표시되는 텍스트의 연결되지 않은 범위가 발생할 수 있습니다.

IUIAutomationTextPattern::GetVisibleRanges 는 텍스트가 보이지 않거나, 모든 텍스트가 보이지 않거나, 텍스트 기반 컨트롤에 텍스트가 없는 경우 퇴화(빈) 텍스트 범위를 검색합니다.

요구 사항

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

추가 정보

IUIAutomationTextPattern

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