IRawElementProviderHwndOverride::GetOverrideProviderForHwnd メソッド (uiautomationcore.h)

指定した要素のUI オートメーション プロバイダーを取得します。

構文

HRESULT GetOverrideProviderForHwnd(
  [in]          HWND                      hwnd,
  [out, retval] IRawElementProviderSimple **pRetVal
);

パラメーター

[in] hwnd

種類: HWND

要素のウィンドウ ハンドル。

[out, retval] pRetVal

種類: IRawElementProviderSimple**

指定したウィンドウの新しいプロバイダーへのポインターを受け取り、プロバイダーがオーバーライドされていない場合は NULL を 受け取ります。 このパラメーターは初期化せずに渡されます。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

このメソッドは、ウィンドウ ベースの子要素を含むフラグメント ルートによって実装されます。 既定では、Windows でホストされているコントロールは、カスタム プロバイダーに加えて、既定のプロバイダーによって提供されます。 既定のプロバイダーは、親ウィンドウ内のすべてのウィンドウを兄弟として扱います。 ウィンドウ ベースのコントロールが別のウィンドウ ベースのコントロールの子と見なされるようにUI オートメーション ツリーを再構築する場合は、フラグメント ルートにこのメソッドを実装して既定のプロバイダーをオーバーライドする必要があります。 返されるプロバイダーは、追加のプロパティを指定したり、指定されたコンポーネントのプロパティをオーバーライドしたりできます。

返されるプロバイダーは、フラグメント ツリーの一部である必要があります。 追加のプロパティを指定したり、指定したコンポーネントのプロパティをオーバーライドしたりできます。

返されたプロバイダーが IRawElementProviderFragment を実装する場合、プロバイダーはフラグメントのツリーの一部であり、フラグメントのルートから移動して到達可能である必要があります。

要件

こちらもご覧ください

IRawElementProviderHwndOverride