Share via


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

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