UiaProviderForNonClient 함수(uiautomationcoreapi.h)

창의 전체 비 클라이언트 영역 또는 창의 비 클라이언트 영역에 있는 컨트롤에 대한 공급자를 가져옵니다.

구문

HRESULT UiaProviderForNonClient(
  [in]  HWND                      hwnd,
  [in]  long                      idObject,
  [in]  long                      idChild,
  [out] IRawElementProviderSimple **ppProvider
);

매개 변수

[in] hwnd

형식: HWND

비 클라이언트 영역 또는 비 클라이언트 컨트롤을 소유하는 창입니다.

[in] idObject

형식: long

비 클라이언트 컨트롤의 개체 식별자이거나 전체 비 클라이언트 영역에 대해 OBJID_WINDOW . 가능한 값 목록은 개체 식별자를 참조하세요.

[in] idChild

형식: long

비 클라이언트 컨트롤의 자식 식별자입니다.

[out] ppProvider

형식: IRawElementProviderSimple**

비 클라이언트 영역 또는 비 클라이언트 컨트롤에 대한 공급자를 받습니다.

반환 값

형식: HRESULT

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

설명

이 함수는 창의 비 클라이언트 영역에 대한 기본 Microsoft UI 자동화 공급자를 반환합니다. UI 자동화 창의 명시적 도움 없이 비 클라이언트 영역을 지원합니다. 이 함수에서 검색하는 IRawElementProviderSimple 인터페이스를 사용하여 지원을 재정의하고 사용자 지정할 수 있습니다.

이 함수는 창이 자체 공급자를 제공할 수 있도록 비 클라이언트 영역에 대한 UI 자동화 기본 공급자를 사용하지 않도록 설정하는 ProviderOptions_RefuseNonClientSupport 플래그와 함께 사용할 때 특히 유용합니다.

비 클라이언트 영역의 컨트롤에 지원되는 개체 ID에는 OBJID_WINDOW, OBJID_VSCROLL, OBJID_HSCROLL, OBJID_TITLEBAR, OBJID_MENU 및 OBJID_SIZEGRIP 포함됩니다. OBJID_TITLEBAR 경우 자식 ID를 사용하여 전체 제목 표시줄과 포함된 단추를 구분합니다.

요구 사항

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

추가 정보

공급자에 대한 함수