Share via

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

  • Article

Récupère l’indicateur actuel de l’interface utilisateur du périphérique pour l’élément .

Cette propriété est en lecture seule.

Syntaxe

HRESULT get_CurrentIsPeripheral(
  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é s’applique aux types de contrôle suivants :

  • UIA_GroupControlTypeId
  • UIA_MenuControlTypeId
  • UIA_PaneControlTypeId
  • UIA_ToolBarControlTypeId
  • UIA_ToolTipControlTypeId
  • UIA_WindowControlTypeId
  • UIA_CustomControlTypeId
L’apparence de l’interface utilisateur de périphérique déclenche souvent l’un de ces événements, si l’interface utilisateur du périphérique prend en charge l’un des modèles appropriés :
  • WindowOpened (UIA_Window_WindowOpenedEventId)
  • MenuOpened (UIA_MenuOpenedEventId)
  • Info-bulleOpened (UIA_ToolTipOpenedEventId)
Lorsque les applications clientes qui sont des technologies d’assistance gèrent l’un de ces événements, le client doit case activée la valeur de CurrentIsPeripheral. Si la valeur est TRUE, le client peut avoir besoin de fournir une autre représentation de l’interface utilisateur de périphérique que l’utilisateur peut atteindre avec une seule action, car le client ne peut pas utiliser le focus modifié comme indicateur d’une nouvelle interface utilisateur ou d’une interface utilisateur intéressante. Sinon, l’interface utilisateur du périphérique n’existe pas dans la vue de contrôle, la séquence d’onglets, etc. Un client est garanti qu’un seul élément d’interface utilisateur de périphérique existe dans l’arborescence globale à tout moment. L’ouverture d’un autre élément ferme automatiquement le premier élément.

Configuration requise

   
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