ITextProvider::GetVisibleRanges 메서드(uiautomationcore.h)

아티클
08/26/2023

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

구문

HRESULT GetVisibleRanges(
  [out, retval] SAFEARRAY **pRetVal
);

매개 변수

[out, retval] pRetVal

형식: SAFEARRAY**

표시되는 텍스트 범위 또는 빈 배열의 ITextRangeProvider 인터페이스에 대한 포인터 배열의 주소를 받습니다. NULL 참조는 반환되지 않습니다. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다.

반환 값

형식: HRESULT

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

설명

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

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

ITextProvider::GetVisibleRanges 는 텍스트가 보이지 않거나, 모든 텍스트가 보기 밖으로 스크롤되거나, 텍스트 기반 컨트롤에 텍스트가 없는 경우 퇴화(빈) 텍스트 범위를 반환해야 합니다.

요구 사항


지원되는 최소 클라이언트	Windows XP [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	uiautomationcore.h(UIAutomation.h 포함)