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
- membres obligatoires pour IValueProvider
- rubriques connexes
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
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
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é.
Rubriques connexes