Metodo IRawElementProviderHwndOverride::GetOverrideProviderForHwnd (uiautomationcore.h)

Articolo
03/08/2023

Ottiene un provider di Automazione interfaccia utente per l'elemento specificato.

Sintassi

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

Parametri

[in] hwnd

Tipo: HWND

Handle della finestra dell'elemento.

[out, retval] pRetVal

Tipo: IRawElementProviderSimple**

Riceve un puntatore al nuovo provider per la finestra specificata o NULL se il provider non viene sottoposto a override. Questo parametro viene passato non inizializzato.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo viene implementato dalle radici del frammento che contengono elementi figlio basati su finestre. Per impostazione predefinita, i controlli ospitati nelle finestre vengono gestiti dai provider predefiniti oltre a qualsiasi provider personalizzato. I provider predefiniti considerano tutte le finestre all'interno di una finestra padre come fratelli. Se si vuole ristrutturare l'albero Automazione interfaccia utente in modo che un controllo basato su finestra sia considerato figlio di un altro, è necessario eseguire l'override del provider predefinito implementando questo metodo nella radice del frammento. Il provider restituito può fornire proprietà aggiuntive o eseguire l'override delle proprietà del componente specificato.

Il provider restituito deve far parte dell'albero dei frammenti. Può fornire proprietà aggiuntive o eseguire l'override delle proprietà del componente specificato.

Se il provider restituito implementa IRawElementProviderFragment, il provider deve far parte dell'albero del frammento e può essere raggiungibile passando dalla radice del frammento.

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

IRawElementProviderHwndOverride

Condividi tramite