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 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

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.

    Ilustración en la que se muestra el 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.

    Ilustración en la que se 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 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.

Tipos de control y sus patrones de control admitidos

Información general acerca de los patrones de control de UI Automation

Información general sobre el árbol de la UI Automation

Patrones de control Text y TextRange