Funzione UiaProviderForNonClient (uiautomationcoreapi.h)

Articolo
03/03/2024

Ottiene il provider per l'intera area non client di una finestra o per un controllo nell'area non client di una finestra.

Sintassi

HRESULT UiaProviderForNonClient(
  [in]  HWND                      hwnd,
  [in]  long                      idObject,
  [in]  long                      idChild,
  [out] IRawElementProviderSimple **ppProvider
);

Parametri

[in] hwnd

Tipo: HWND

Finestra proprietaria dell'area non client o del controllo non client.

[in] idObject

Tipo: long

Identificatore dell'oggetto del controllo non client o OBJID_WINDOW per l'intera area non client. Per un elenco dei valori possibili, vedere Identificatori di oggetto.

[in] idChild

Tipo: long

Identificatore figlio del controllo non client.

[out] ppProvider

Tipo: IRawElementProviderSimple**

Riceve il provider per l'area non client o il controllo non client.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se ha esito positivo o un valore di errore in caso contrario.

Commenti

Questa funzione restituisce il provider di Automazione interfaccia utente Microsoft predefinito per l'area non client di una finestra. Automazione interfaccia utente supporta l'area non client senza alcuna guida esplicita dalla finestra. È possibile eseguire l'override e personalizzare il supporto usando l'interfaccia IRawElementProviderSimple recuperata da questa funzione.

Questa funzione è particolarmente utile quando viene usata con il flag di ProviderOptions_RefuseNonClientSupport, che disabilita il provider predefinito Automazione interfaccia utente per l'area non client in modo che la finestra possa fornire il proprio provider.

Gli ID oggetto supportati per i controlli nell'area non client includono OBJID_WINDOW , OBJID_VSCROLL, OBJID_HSCROLL, OBJID_TITLEBAR, OBJID_MENU e OBJID_SIZEGRIP. Per OBJID_TITLEBAR, usare l'ID figlio per distinguere tra l'intera barra del titolo e i pulsanti in esso contenuti.

Requisiti

Requisito	Valore
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

Condividi tramite