Partager via


Modèle de contrôle de valeur

Décrit les instructions et conventions d’implémentation IValueProvider, y compris des informations sur les propriétés et les méthodes. Le modèle de contrôle valeur est utilisé pour prendre en charge les contrôles qui ont une valeur intrinsèque qui 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ôle et leurs modèles de contrôle pris en charge.

Cette rubrique contient les sections suivantes.

Directives et conventions de mise en œuvre

Lors de l’implémentation du modèle de contrôle valeur, notez les instructions 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 Valeur 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 valeur 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 à plusieurs lignes et uniques doivent implémenter ITextProvider pour exposer leur contenu en lecture seule.

  • Les contrôles d’édition à plusieurs lignes 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 nuance 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 obligatoires Type de membre Notes
IsReadOnly Propriété Aucun
valeur Propriété Aucun
SetValue Méthode Aucun

 

Ce modèle de contrôle n’a aucun événement associé.

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

modèles de contrôle Text et TextRange