ITextProvider2::GetCaretRange 메서드(uiautomationcore.h)

텍스트 기반 컨트롤에 속하는 caret의 위치에 길이가 0인 텍스트 범위를 제공합니다.

구문

HRESULT GetCaretRange(
  [out]         BOOL               *isActive,
  [out, retval] ITextRangeProvider **pRetVal
);

[out] isActive

형식: BOOL*

TRUE 이면 caret가 포함된 텍스트 기반 컨트롤에 키보드 포커스가 있으면 FALSE입니다.

[out, retval] pRetVal

텍스트 기반 컨트롤에 속하는 캐럿의 현재 위치를 나타내는 텍스트 범위입니다.

형식: HRESULT

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

isActive 매개 변수가 FALSE이면 텍스트 기반 컨트롤에 속하는 caret가 시스템 caret와 동일한 위치에 있지 않을 수 있습니다.

이 메서드는 클라이언트가 텍스트 기반 컨트롤에 속하는 캐럿의 경계 사각형을 찾거나 캐럿 근처의 텍스트를 찾는 데 사용할 수 있는 텍스트 범위를 검색합니다.

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