Styles (modèle de contrôle)

Fournit des instructions et des conventions pour l’implémentation de IStylesProvider, y compris des informations sur les propriétés et les méthodes. Le modèle de contrôle styles est utilisé pour décrire un élément d’interface utilisateur doté d’un style, d’une couleur de remplissage, d’un motif de remplissage ou d’une forme spécifique.

Le modèle de contrôle styles est particulièrement utile pour décrire des éléments dans un document, qui ont souvent ces styles. Les styles contiennent généralement des informations qui sont utiles pour les clients handicapés ; par exemple, un style peut décrire une certaine chaîne comme titre d’un document ou un certain objet Flowchart comme un losange ou un cercle. Pour obtenir des exemples de contrôles qui implémentent ce modèle de contrôle, consultez types de contrôle et leurs modèles de contrôle pris en charge.

Cette rubrique contient les sections suivantes.

Conventions et directives d'implémentation

Lorsque vous implémentez le modèle de contrôle styles , notez les conventions et recommandations suivantes :

  • Le fichier d’en-tête UIAutomationClient. h définit un ensemble de valeurs constantes nommées utilisées pour identifier plusieurs styles courants. Pour plus d’informations, consultez identificateurs de style.
  • Si vous utilisez StyleId _ Custom, vous devez implémenter la propriété IStylesProvider :: styleName pour permettre aux clients de découvrir le nom du style. Vous n’avez pas besoin d’implémenter la propriété styleName pour un style standard, car Microsoft UI Automation fournit un nom par défaut, mais vous pouvez l’implémenter si vous devez remplacer le nom par défaut.
  • Les autres propriétés dans le modèle de styles sont facultatives. le fournisseur peut retourner UIA _ E _ NOTSUPPORTED pour une propriété qui n’est pas prise en charge.
  • Les styles d’une plage de texte peuvent être représentés à l’aide des attributs de texte suivants :
    • Lors de la réponse à une demande pour l’attribut de texte StyleId , la plage de texte doit retourner l’un des identificateurs de style décrits dans identificateurs de style.
    • Si StyleId _ personnalisé est utilisé, la plage de texte doit retourner une valeur de chaîne pour l’attribut de texte styleName pour permettre aux clients de découvrir le nom du style.
    • Une plage de texte qui a plusieurs styles, tels que le titre et le texte normal, doit retourner la propriété ReservedMixedAttributeValue spéciale UI Automation pour les propriétés StyleId et styleName . Un client recevant cette réponse peut subdiviser la plage de texte pour Rechercher l’endroit où les styles commencent et se terminent.
  • Les applications peuvent utiliser un large éventail de styles pour décrire les objets, mais UI Automation représente uniquement les plus courants. Pour représenter des attributs de style supplémentaires, tels que la couleur de bordure, un fournisseur peut retourner une liste d’attributs supplémentaires dans la propriété ExtendedProperties . Il s’agit fondamentalement d’un conteneur de propriétés avec un ensemble de propriétés étendues, telles que «BorderColor = 0xFF0000 ; BorderStyle = pointillés». Les valeurs des propriétés étendues peuvent être spécifiques à l’application.

Membres requis pour IStylesProvider

Les propriétés suivantes sont requises pour implémenter l’interface IStylesProvider .

Membres nécessaires Type de membre Remarques
ExtendedProperties Propriété Aucun
FillColor Propriété Aucun
FillPatternColor Propriété Aucun
FillPatternStyle Propriété Aucun
Forme Propriété Aucun
StyleId Propriété Aucun
StyleName Propriété Aucun

Ce modèle de contrôle n’est associé à aucune méthode ou aucun événement.

Types de contrôle et leurs modèles de contrôle pris en charge

Vue d'ensemble des modèles de contrôle UI Automation

Vue d’ensemble de l’arborescence UI Automation