다음을 통해 공유


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

범위의 일반 텍스트를 검색합니다.

구문

HRESULT GetText(
  [in]          int  maxLength,
  [out, retval] BSTR *pRetVal
);

매개 변수

[in] maxLength

형식: int

반환할 문자열의 최대 길이입니다. 제한할 필요가 없으면 -1을 사용합니다.

[out, retval] pRetVal

형식: BSTR*

지정된 최대 길이로 잘린 텍스트 범위의 일반 텍스트를 받습니다. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다.

반환 값

형식: HRESULT

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

설명

ITextRangeProvider::GetText 는 숨겨진 텍스트와 표시되는 텍스트를 모두 검색합니다.

maxLength가 호출자의 텍스트 범위 길이보다 크면 반환되는 문자열은 텍스트 범위의 일반 텍스트가 됩니다.

ITextRangeProvider::GetText 는 텍스트 흐름의 엔드포인트 순서에 영향을 받지 않습니다. 논리 텍스트 흐름 순서에서 항상 텍스트 범위의 시작 엔드포인트와 끝점 사이의 텍스트를 반환합니다.

요구 사항

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

추가 정보

개념

ITextProvider

ITextRangeProvider

참조

UI 자동화 공급자 개요