Compartir a través de

Patrón de control value

  • Artículo

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 se puede editar, 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.

Este tema contiene las secciones siguientes.

Directrices y convenciones de implementación

Al implementar el patrón de control value de, 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 Value si se puede editar el valor de cualquiera de los elementos, independientemente del modo de edición actual del control. El control primario también debe admitir el patrón de control Value si los elementos secundarios son editables. En la imagen siguiente se muestra un ejemplo de un elemento de lista editable.

    ilustración de que muestra de elementos de lista editables

  • Los controles de edición de una y 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. ImplementeITextProvider en estos escenarios.

  • IValueProvider deben 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 interno equivalente RGB.

    ilustración de que muestra la asignación de cadenas de muestra de color

  • 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 interfazIValueProvider.

Miembros necesarios Tipo de miembro Notas
isReadOnly Propiedad Ninguno
valor de Propiedad Ninguno
SetValue Método Ninguno

 

Este patrón de control no tiene eventos asociados.

tipos de control y sus patrones de control admitidos

Introducción a los patrones de control de automatización de la interfaz de usuario de

Información general del árbol de automatización de la interfaz de usuario de

patrones de control Text y TextRange