Vue d'ensemble des types de contrôle UI Automation

Les types de contrôle Microsoft UI Automation sont des propriétés qui servent d’identificateurs connus qui indiquent le type de contrôle représenté par un élément d’interface utilisateur particulier, tel qu’une zone de liste déroulante ou un bouton. Les applications clientes utilisent le type pour identifier les fonctionnalités d’un contrôle et pour déterminer comment interagir avec lui.

Cette rubrique contient les sections suivantes :

Conditions requises pour le type de contrôle UI Automation

Chaque type de contrôle UI Automation possède un ensemble de conditions qui lui sont associées. Lorsqu’un fournisseur assigne un type de contrôle à un contrôle, le fournisseur doit s’assurer que le contrôle remplit toutes les conditions associées à ce type de contrôle. Les conditions sont les suivantes :

  • Modèles de contrôle UI Automation : chaque type de contrôle a un ensemble de modèles de contrôle que le contrôle doit prendre en charge, un jeu facultatif et un ensemble que le contrôle ne doit pas prendre en charge.
  • Valeurs de propriété UI Automation : chaque type de contrôle possède un jeu de propriétés que le contrôle doit prendre en charge.
  • Événements UI Automation : chaque type de contrôle possède un jeu d’événements que le contrôle doit prendre en charge.
  • Structure de l’arborescence UI Automation : chaque type de contrôle définit la façon dont le contrôle doit apparaître dans la structure de l’arborescence UI Automation.

Lorsqu’un contrôle répond aux conditions d’un type de contrôle particulier, la valeur de la propriété IUIAutomationElement :: CurrentControlType (ou IUIAutomationElement :: CachedControlType) indique ce type de contrôle.

Si votre contrôle ne répond pas aux spécifications d’un type de contrôle particulier, utilisez UIA _ CUSTOMCONTROLTYPEID comme ID de type de contrôle et décrivez complètement le contrôle à l’aide des modèles de contrôle et des propriétés appropriés. Vous pouvez également définir la propriété UIA _ LocalizedControlTypePropertyId sur une chaîne qui décrit le mieux le type de votre contrôle.

Propriété LocalizedControlType

Si vous utilisez un type de contrôle prédéfini pour décrire votre contrôle, utilisez la valeur par défaut pour la propriété UIA _ LocalizedControlTypePropertyId et autoriser UI Automation à fournir une chaîne localisée pour que les fournisseurs exposent correctement. Si vous ne pouvez pas utiliser un type de contrôle prédéfini pour décrire votre contrôle, définissez la propriété UIA _ LocalizedControlTypePropertyId sur une chaîne localisée qui décrit avec précision le type de votre contrôle. La chaîne doit être concise, mais suffisamment précise qu’une technologie d’assistance comme un lecteur d’écran peut l’utiliser dans l’interface utilisateur pour informer l’utilisateur du type du contrôle.

Types de contrôle UI Automation actuels

Les rubriques suivantes décrivent les types de contrôle UI Automation. Pour chaque type de contrôle, la description comprend l’ensemble de conditions qu’un contrôle du type donné doit prendre en charge :

Informations de référence

Identificateurs de type de contrôle

Conceptuel

Prise en charge des types de contrôle UI Automation

Prise en charge d'UI Automation pour les contrôles standard

Notions de base d’UI Automation