Patrón de control value
Describe instrucciones y convenciones para implementar IValueProvider, incluida información sobre las propiedades y los métodos. El patrón de control Value se usa para admitir controles que tienen un valor intrínseco que no abarca un intervalo y que se pueden representar como una cadena.
La cadena de valor puede ser editable, según el control y su configuración. Para obtener ejemplos de controles que implementan este patrón de control, vea Tipos de control y sus patrones de control admitidos.
En este tema se incluyen las siguientes secciones.
- Directrices y convenciones de implementación
- Miembros necesarios para IValueProvider
- Temas relacionados
Directrices y convenciones de implementación
Al implementar el patrón de control Value , tenga en cuenta las siguientes directrices y convenciones:
Los controles como un elemento de lista o un elemento de árbol deben admitir el patrón de control Valor si el valor de cualquiera de los elementos se puede editar, independientemente del modo de edición actual del control. El control primario también debe admitir el patrón de control Valor si los elementos secundarios son editables. En la imagen siguiente se muestra un ejemplo de un elemento de lista editable.
Los controles de edición de una sola línea y de varias líneas deben implementar ITextProvider para exponer su contenido de solo lectura.
Los controles de edición de varias líneas deben implementar IValueProvider si se puede cambiar su contenido.
IValueProvider no admite la recuperación de información de formato o valores de subcadena. Implemente ITextProvider en estos escenarios.
IValueProvider debe implementarse mediante controles como el control de selección del selector de colores de Microsoft Word (vea la siguiente imagen), que admite la asignación de cadenas entre un valor de color (por ejemplo, "amarillo") y un valor RGB interno equivalente.
Un control debe tener su propiedad IsEnabled establecida en TRUE y su propiedad ITextProvider::IsReadOnly establecida en FALSE antes de permitir una llamada a ITextProvider::SetValue.
Miembros necesarios para IValueProvider
Se requieren las siguientes propiedades y métodos para implementar la interfaz IValueProvider .
| Miembros requeridos | Tipo de miembro | Notas |
|---|---|---|
| IsReadOnly | Propiedad | None |
| Valor | Propiedad | None |
| SetValue | Método | None |
Este patrón de control no tiene eventos asociados.
Temas relacionados