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 を含む) |