Metodo IRawElementProviderSimple::get_HostRawElementProvider (uiautomationcore.h)

  • Articolo

Specifica il provider host per questo elemento.

Questa proprietà è di sola lettura.

Sintassi

HRESULT get_HostRawElementProvider(
  IRawElementProviderSimple **pRetVal
);

Parametri

pRetVal

Valore restituito

nessuno

Osservazioni

Questa proprietà è in genere il provider di Automazione interfaccia utente Microsoft per la finestra di un controllo personalizzato. Automazione interfaccia utente usa questo provider in combinazione con il provider personalizzato. Ad esempio, l'identificatore di runtime dell'elemento viene in genere ottenuto dal provider host.

Un provider host deve essere restituito nei casi seguenti: quando l'elemento è una radice di frammento, quando l'elemento è un elemento semplice (ad esempio un pulsante push) e quando il provider è un segnaposto di riposizionamento (per altre informazioni, vedere Riposizionamento provider). In altri casi, la proprietà deve essere NULL.

Esempio

Nell'esempio seguente viene restituito il provider host per la finestra che ospita il controllo servito da questo provider.

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

Requisiti

Requisito Valore
Client minimo supportato Windows XP [app desktop | App UWP]
Server minimo supportato Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione uiautomationcore.h (includere UIAutomation.h)

Vedi anche

IRawElementProviderSimple

UiaHostProviderFromHwnd