Fonction UiaProviderForNonClient (uiautomationcoreapi.h)

Obtient le fournisseur pour l’ensemble de la zone non cliente d’une fenêtre ou pour un contrôle dans la zone non cliente d’une fenêtre.

Syntaxe

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

Paramètres

[in] hwnd

Type : HWND

Fenêtre qui possède la zone non cliente ou le contrôle non client.

[in] idObject

Type : long

Identificateur d’objet du contrôle non client ou OBJID_WINDOW pour l’ensemble de la zone non cliente. Pour obtenir la liste des valeurs possibles, consultez Identificateurs d’objet.

[in] idChild

Type : long

Identificateur enfant du contrôle non client.

[out] ppProvider

Type : IRawElementProviderSimple**

Reçoit le fournisseur pour la zone non cliente ou le contrôle non client.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite ou une valeur d’erreur dans le cas contraire.

Remarques

Cette fonction retourne le fournisseur Microsoft UI Automation par défaut pour la zone non cliente d’une fenêtre. UI Automation prend en charge la zone non cliente sans aucune aide explicite de la fenêtre. Vous pouvez remplacer et personnaliser la prise en charge à l’aide de l’interface IRawElementProviderSimple récupérée par cette fonction.

Cette fonction est particulièrement utile lorsque vous l’utilisez avec l’indicateur ProviderOptions_RefuseNonClientSupport, qui désactive le UI Automation fournisseur par défaut pour la zone non cliente afin que la fenêtre puisse fournir son propre fournisseur.

Les ID d’objet pris en charge pour les contrôles dans la zone non client incluent OBJID_WINDOW, OBJID_VSCROLL, OBJID_HSCROLL, OBJID_TITLEBAR, OBJID_MENU et OBJID_SIZEGRIP. Par OBJID_TITLEBAR, utilisez l’ID enfant pour faire la distinction entre la barre de titre entière et les boutons qu’elle contient.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau | Applications UWP]
Plateforme cible	Windows
En-tête	uiautomationcoreapi.h
Bibliothèque	Uiautomationcore.lib
DLL	Uiautomationcore.dll

Voir aussi

Fonctions pour les fournisseurs