Export (0) Print
Expand All

IRawElementProviderSimple::HostRawElementProvider property

Specifies the host provider for this element.

This property is read-only.

Syntax


HRESULT get_HostRawElementProvider(
  [out, retval]  IRawElementProviderSimple **pRetVal
);

Property value

Type: IRawElementProviderSimple**

The host provider. This parameter is passed uninitialized.

Remarks

This property is generally the Microsoft UI Automation provider for the window of a custom control. UI Automation uses this provider in combination with the custom provider. For example, the runtime identifier of the element is usually obtained from the host provider.

A host provider must be returned in the following cases: when the element is a fragment root, when the element is a simple element (such as a push button), and when the provider is a repositioning placeholder (for more information, see Provider Repositioning). In other cases, the property should be NULL.

Examples

The following example returns the host provider for the window that hosts the control served by this provider.


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

Requirements

Minimum supported client

Windows XP [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2003 [desktop apps | Windows Store apps]

Header

UIAutomationCore.h (include UIAutomation.h)

IDL

UIAutomationCore.idl

See also

IRawElementProviderSimple
UiaHostProviderFromHwnd

 

 

Community Additions

ADD
Show:
© 2014 Microsoft