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

텍스트 기반 컨트롤에서 현재 선택한 텍스트를 나타내는 텍스트 범위의 컬렉션을 검색합니다.

구문

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

[out, retval] pRetVal

형식: SAFEARRAY**

선택한 각 텍스트 범위에 대해 하나씩 텍스트 범위의 ITextRangeProvider 인터페이스에 대한 포인터 배열의 주소를 받습니다. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다.

형식: HRESULT

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

텍스트 선택을 지원하는 UI 자동화 공급자의 경우 공급자는 이 메서드를 구현하고 ITextProvider::SupportedTextSelection 값도 반환해야 합니다.

컨트롤에 선택한 텍스트의 단일 범위만 포함된 경우 pRetVal 배열에는 단일 텍스트 범위가 포함되어야 합니다.

컨트롤에 텍스트 삽입 지점이 포함되어 있지만 텍스트가 선택되지 않은 경우 pRetVal 배열은 텍스트 삽입 지점의 위치에 퇴화(빈) 텍스트 범위를 포함해야 합니다.

컨트롤에 선택한 텍스트가 없거나 컨트롤에 텍스트 삽입 지점이 없는 경우 pRetVal 을 NULL로 설정합니다.


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

개념

참조