IRawElementProviderSimple::get_HostRawElementProvider メソッド (uiautomationcore.h)

  • [アーティクル]

この要素のホスト プロバイダーを指定します。

このプロパティは読み取り専用です。

構文

HRESULT get_HostRawElementProvider(
  IRawElementProviderSimple **pRetVal
);

パラメーター

pRetVal

戻り値

なし

解説

このプロパティは、通常、カスタム コントロールのウィンドウの Microsoft UI オートメーション プロバイダーです。 UI オートメーションでは、このプロバイダーをカスタム プロバイダーと組み合わせて使用します。 たとえば、 要素のランタイム識別子は通常、ホスト プロバイダーから取得されます。

ホスト プロバイダーは、要素がフラグメント ルートの場合、要素が単純な要素 (プッシュ ボタンなど) の場合、およびプロバイダーが再配置プレースホルダーである場合 (詳細については、「 プロバイダーの再配置」を参照) の場合に返す必要があります。 それ以外の場合は、 プロパティを NULL にする必要があります。

例

次の例では、このプロバイダーによって提供されるコントロールをホストするウィンドウのホスト プロバイダーを返します。

HRESULT STDMETHODCALLTYPE Provider::get_HostRawElementProvider(IRawElementProviderSimple** pRetVal)
{
    return UiaHostProviderFromHwnd(controlHWnd, pRetVal); 
}

要件

要件 値
サポートされている最小のクライアント Windows XP [デスクトップ アプリ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ]
対象プラットフォーム Windows
ヘッダー uiautomationcore.h (UIAutomation.h を含む)

こちらもご覧ください

IRawElementProviderSimple

UiaHostProviderFromHwnd