다음을 통해 공유


TextRange_GetText 함수(uiautomationcoreapi.h)

참고 이 함수는 더 이상 사용되지 않습니다. 클라이언트 애플리케이션은 Microsoft UI 자동화 COM(구성 요소 개체 모델) 인터페이스를 대신 사용해야 합니다.
 
텍스트 범위의 텍스트를 지정된 수의 문자까지 반환합니다.

구문

HRESULT TextRange_GetText(
  [in]  HUIATEXTRANGE hobj,
  [in]  int           maxLength,
  [out] BSTR          *pRetVal
);

매개 변수

[in] hobj

형식: HUIATEXTRANGE

텍스트 범위 개체입니다.

[in] maxLength

형식: int

텍스트 범위의 시작 엔드포인트에 있는 문자부터 시작하여 반환할 문자 수입니다.

[out] pRetVal

형식: BSTR*

이 함수가 반환되면 이 매개 변수에는 반환된 텍스트에 대한 포인터가 포함됩니다. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다.

반환 값

형식: HRESULT

성공하면 S_OK 반환하고, 그렇지 않으면 오류 값을 반환합니다.

설명

maxLength가 -1이면 텍스트 범위 내의 모든 텍스트가 반환됩니다. maxLength가 텍스트 범위의 길이보다 큰 경우 반환된 문자열에는 텍스트 범위의 모든 텍스트가 포함됩니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 uiautomationcoreapi.h
라이브러리 Uiautomationcore.lib
DLL Uiautomationcore.dll