Modèle de contrôle styles

Décrit les instructions et conventions d’implémentation d’IStylesProvider, notamment 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 motif de remplissage ou une forme spécifiques.

Le modèle de contrôle Styles est particulièrement utile pour décrire les éléments d’un document, qui ont souvent de tels styles. Les styles comportent généralement des informations utiles pour les clients présentant un handicap; Par exemple, un style peut décrire une certaine chaîne comme titre d’un document, ou un objet organigramme en tant que losange ou cercle. Pour obtenir des exemples de contrôles qui implémentent ce modèle de contrôle, consultez Les 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 via 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 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 trouver où les styles commencent et se terminent.
  • Les applications peuvent utiliser un large éventail 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 renvoyer 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=pointillé « . 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 Notes
ExtendedProperties Property None
FillColor Property None
FillPatternColor Propriété None
FillPatternStyle Property None
Forme Property None
StyleId Property None
StyleName Property None

 

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

Types de contrôles et 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