Funzione UiaProviderFromIAccessible (uiautomationcoreapi.h)

Articolo
08/26/2023

Crea un provider di Automazione interfaccia utente Microsoft in base all'oggetto Microsoft Active Accessibility specificato.

Sintassi

HRESULT UiaProviderFromIAccessible(
  [in]  IAccessible               *pAccessible,
  [in]  long                      idChild,
  [in]  DWORD                     dwFlags,
  [out] IRawElementProviderSimple **ppProvider
);

Parametri

[in] pAccessible

Tipo: IAccessible*

Puntatore all'oggetto Microsoft Active Accessibility.

[in] idChild

Tipo: long

ID figlio dell'oggetto Microsoft Active Accessibility.

[in] dwFlags

Tipo: DWORD

Uno dei valori seguenti:

UIA_PFIA_DEFAULT

UIA_PFIA_UNWRAP_BRIDGE

[out] ppProvider

Tipo: IRawElementProviderSimple**

Nuovo provider di Automazione interfaccia utente.

Valore restituito

Tipo: HRESULT

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

Commenti

Automazione interfaccia utente garantisce la compatibilità con le versioni precedenti per i provider di Microsoft Active Accessibility fornendo un proxy, denominato Microsoft Active Accessibility per Automazione interfaccia utente proxy. Questo proxy viene creato automaticamente quando una finestra risponde a un messaggio WM_GETOBJECT restituendo un provider microsoft Active Accessibility. Usare UiaProviderFromIAccessible quando è necessario creare manualmente un microsoft Active Accessibility per Automazione interfaccia utente proxy, ad esempio quando si implementa l'interfaccia IAccessibleEx.

Alcune proprietà, ad esempio LabeledBy, devono essere espresse come provider di Automazione interfaccia utente. Un provider IAccessibleEx può usare UiaProviderFromIAccessible per eseguire il wrapping di un oggetto IAccessible per restituirlo come valore della proprietà LabeledBy.

Requisiti


Client minimo supportato	Windows 8 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2012 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	uiautomationcoreapi.h
Libreria	Uiautomationcore.lib
DLL	Uiautomationcore.dll

Vedi anche

Funzioni per i provider

UiaIAccessibleFromProvider

Condividi tramite