Partager via


Modèle de contrôle de valeur

Décrit les instructions et conventions pour l’implémentation d’IValueProvider, y compris des informations sur les propriétés et les méthodes. Le modèle de contrôle Value est utilisé pour prendre en charge les contrôles dont la valeur intrinsèque ne couvre pas une plage et qui peuvent être représentés sous forme de chaîne.

La chaîne de valeur peut être modifiable, en fonction du contrôle et de ses paramètres. 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 Value , notez les directives et conventions suivantes :

  • Les contrôles tels qu’un élément de liste ou un élément d’arborescence doivent prendre en charge le modèle de contrôle Value si la valeur de l’un des éléments est modifiable, quel que soit le mode d’édition actuel du contrôle. Le contrôle parent doit également prendre en charge le modèle de contrôle Value si les éléments enfants sont modifiables. L’image suivante montre un exemple d’élément de liste modifiable.

    illustration montrant l’élément de liste modifiable

  • Les contrôles d’édition monoligne et multiligne doivent implémenter ITextProvider pour exposer leur contenu en lecture seule.

  • Les contrôles d’édition multilignes doivent implémenter IValueProvider si leur contenu peut être modifié.

  • IValueProvider ne prend pas en charge la récupération des informations de mise en forme ou des valeurs de sous-chaîne. Implémentez ITextProvider dans ces scénarios.

  • IValueProvider doit être implémenté par des contrôles tels que le contrôle de sélection du sélecteur de couleurs de Microsoft Word (voir l’image suivante), qui prend en charge le mappage de chaînes entre une valeur de couleur (par exemple, « jaune ») et une valeur RVB interne équivalente.

    illustration montrant le mappage de chaînes de nuances de couleur

  • Un contrôle doit avoir sa propriété IsEnabled définie sur TRUE et sa propriété ITextProvider::IsReadOnly définie sur FALSE avant d’autoriser un appel à ITextProvider::SetValue.

Membres obligatoires pour IValueProvider

Les propriétés et méthodes suivantes sont requises pour implémenter l’interface IValueProvider .

Membres nécessaires Type de membre Notes
IsReadOnly Propriété Aucun
Valeur Propriété Aucun
SetValue Méthode Aucun

 

Ce modèle de contrôle n’est associé 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

Modèles de contrôle Text et TextRange