Méthode IUIAutomationElement3 ::get_CachedIsPeripheral (uiautomationclient.h)

Article
08/26/2023

Récupère l’indicateur d’interface utilisateur périphérique mis en cache pour l’élément . L’interface utilisateur périphérique s’affiche et prend en charge l’interaction utilisateur, mais ne prend pas le focus sur le clavier lorsqu’elle apparaît. Les exemples d’interface utilisateur périphérique incluent les fenêtres contextuelles, les menus volants, les menus contextuels ou les notifications flottantes.

Cette propriété est en lecture seule.

Syntaxe

HRESULT get_CachedIsPeripheral(
  BOOL *retVal
);

Paramètres

retVal

Valeur de retour

None

Remarques

Lorsque la propriété IsPeripheral a la valeur TRUE, une application cliente ne peut pas supposer que le focus a été pris par l’élément, même s’il est actuellement interactif au clavier.

Cette propriété est pertinente pour ces types de contrôles :

UIA_GroupControlTypeId
UIA_MenuControlTypeId
UIA_PaneControlTypeId
UIA_ToolBarControlTypeId
UIA_ToolTipControlTypeId
UIA_WindowControlTypeId
UIA_CustomControlTypeId

L’apparence de l’interface utilisateur périphérique déclenche souvent l’un de ces événements, si l’interface utilisateur périphérique prend en charge l’un des modèles appropriés :

WindowOpened (UIA_Window_WindowOpenedEventId)
MenuOuvert (UIA_MenuOpenedEventId)
Info-bulleOpened (UIA_ToolTipOpenedEventId)

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8.1 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	uiautomationclient.h (incluez UIAutomation.h)

Voir aussi

IUIAutomationElement3

Référence

Partager via