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

  • Article

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 que représente 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 déterminer comment interagir avec celui-ci.

Cette rubrique contient les sections suivantes :

Conditions requises pour le type de contrôle UI Automation

Chaque type de contrôle UI Automation est associé à un ensemble de conditions. Lorsqu’un fournisseur affecte un type de contrôle à un contrôle, celui-ci doit s’assurer que le contrôle remplit toutes les conditions associées à ce type de contrôle. Les conditions sont les suivantes :

  • UI Automation modèles de contrôle : chaque type de contrôle a un ensemble de modèles de contrôle que le contrôle doit prendre en charge, un ensemble 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 remplit les conditions d’un type de contrôle particulier, la valeur de 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 et propriétés de contrôle 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 de la propriété UIA_LocalizedControlTypePropertyId et autorisez UI Automation à fournir une chaîne localisée pour que les fournisseurs s’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 précisément le type de votre contrôle. La chaîne doit être concise, mais suffisamment précise pour qu’une technologie d’assistance telle qu’un lecteur d’écran puisse 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 inclut l’ensemble des 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