다음을 통해 공유


ITextRangeProvider::GetChildren 메서드(uiautomationcore.h)

지정된 텍스트 범위 내에 포함되거나 완전히 포함되고 지정된 텍스트 범위에 대한 바깥쪽 요소 의 자식 요소인 모든 요소의 컬렉션을 검색합니다.

구문

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

매개 변수

[out, retval] pRetVal

형식: SAFEARRAY**

텍스트 범위로 묶인 모든 자식 요소에 대한 IRawElementProviderSimple 인터페이스에 대한 포인터 배열입니다(해당 범위의 시작 엔드포인트를 기준으로 정렬됨).

텍스트 범위에 자식 요소가 포함되지 않으면 빈 컬렉션이 반환됩니다.

이 매개 변수는 초기화되지 않은 상태로 전달됩니다.

반환 값

형식: HRESULT

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

설명

ITextRangeProvider::GetChildren로 검색된 각 요소에는 RangeFromChild를 통해 검색할 수 있는 유효한 텍스트 범위가 있습니다. 여기에는 ITextProvider와 자식 요소 간의 UI 자동화 트리에 있는 모든 요소가 포함됩니다.

예제

  1. 이 예제에서는 이미지 링크가 포함된 텍스트 스트림을 보여 줍니다. 링크는 이미지의 자식이지만 둘 다 동일한 텍스트 범위에 걸쳐 있으며 텍스트 스트림 내에 포함된 개체로 노출됩니다.

    Hello <Image Link> World

  2. 이 예제에서는 텍스트로 둘러싸인 두 셀 테이블이 포함된 텍스트 스트림을 보여 줍니다.

    텍스트 시작

    표 셀 1표 셀 2

    끝 텍스트

요구 사항

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

추가 정보

ITextProvider, ITextRangeProvider, GetEnclosingElement, ITextProvider::RangeFromChild, UI 자동화 공급자 개요, 안전한 배열 사용에 대한 모범 사례