Styles, modèle de contrôle

  • Article

Décrit des instructions et des conventions pour l’implémentation d’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 qui a un style, une couleur de remplissage, un modèle de remplissage ou une forme spécifique.

Le modèle de contrôle Styles est particulièrement utile pour décrire les éléments d’un document, qui ont fréquemment de tels styles. Les styles contiennent généralement des informations 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 d’organigramme sous la forme d’un diamant ou d’un cercle. Pour obtenir des exemples de contrôles qui implémentent ce modèle de contrôle, consultez Types de contrôles et leurs modèles de contrôle pris en charge.

Cette rubrique contient les sections suivantes.

Conventions et directives d'implémentation

Lors de l’implémentation du modèle de contrôle Styles , notez les instructions et conventions 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 du modèle 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 par les attributs de texte suivants :
    • Lorsque vous répondez à 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_Custom est utilisé, la plage de texte doit retourner une valeur de chaîne pour l’attribut de texte StyleName afin de 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 UI Automation spéciale pour les propriétés StyleId et StyleName. Un client recevant cette réponse peut subdiviser la plage de texte pour trouver où les styles commencent et se terminent.
  • Les applications peuvent utiliser une grande variété de styles pour décrire des 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 essentiellement d’un conteneur de propriétés avec un ensemble de propriétés étendues, telles que « BorderColor=0xFF0000 ; BorderStyle=dotted ». Les valeurs des propriétés étendues peuvent être spécifiques à l’application.

Membres obligatoires pour IStylesProvider

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

Membres nécessaires Type de membre Notes
ExtendedProperties Propriété Aucun
FillColor Propriété Aucun
FillPatternColor Propriété Aucun
FillPatternStyle Propriété Aucun
Graphique à base de formes 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ôles 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