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 インターフェイスを使用して、サポートをオーバーライドおよびカスタマイズできます。

この関数は、ProviderOptions_RefuseNonClientSupport フラグと共に使用する場合に特に便利です。これにより、ウィンドウが独自のプロバイダーを提供できるように、クライアント以外の領域の既定のプロバイダー UI オートメーション無効になります。

クライアント以外の領域のコントロールでサポートされているオブジェクト 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
Library	Uiautomationcore.lib
[DLL]	Uiautomationcore.dll

こちらもご覧ください

プロバイダーの関数