Implementar el patrón de control Value de UI Automation

Artículo
08/10/2011

Nota
Esta documentación está dirigida a desarrolladores de .NET Framework que desean usar las clases administradas de UI Automation definidas en el espacio de nombres System.Windows.Automation.Para obtener información actualizada sobre UI Automation, vea Windows Automation API: UI Automation.

En este tema se presentan las directrices y convenciones de implementación de IValueProvider, incluida la información acerca de eventos y propiedades. Los vínculos a referencias adicionales se enumeran al final del tema.

El patrón de control ValuePattern se utiliza para admitir controles que tienen un valor intrínseco que no abarca un intervalo y que se puede representar como cadena. Esta cadena se puede modificar, en función del control y de su configuración. Para obtener ejemplos de controles que implementan este patrón, vea Asignación de patrones de controles para clientes de UI Automation.

Este tema contiene las secciones siguientes.

Directrices y convenciones de implementación
Miembros necesarios para IValueProvider
Excepciones
Temas relacionados

Directrices y convenciones de implementación

Al implementar el patrón de control Value, tenga en cuenta las directrices y convenciones siguientes:

Los controles como ListItem y TreeItem deben admitir ValuePattern si el valor de alguno de los elementos se puede modificar, con independencia del modo de edición actual del control. El control primario también debe admitir ValuePattern si los elementos secundarios son modificables.

Ejemplo de elemento de lista modificable

Elemento de lista modificable.

Los controles de edición de una sola línea admiten el acceso mediante programación a su contenido mediante la implementación de IValueProvider. Sin embargo, los controles de edición multilínea no implementan IValueProvider; en su lugar, proporcionan acceso a su contenido mediante la implementación de ITextProvider.
Para recuperar el contenido textual de un control de edición multilínea, éste debe implementar ITextProvider. Sin embargo, ITextProvider no permite establecer el valor de un control.
IValueProvider no permite recuperar información de formato ni valores de subcadena. Implemente ITextProvider en estos escenarios.
Los controles como el control de selección Selector de color de Microsoft Word deben implementar IValueProvider (vea la siguiente ilustración), que admite una asignación de cadena entre un valor de color (por ejemplo, "amarillo") y una estructura RGB interna equivalente.

Ejemplo de asignación de cadenas de muestrario de color

Selector de color con amarillo resaltado.

Un control debe tener el campo IsEnabledProperty establecido en true y el campo IsReadOnlyProperty establecido en false antes de permitir una llamada a SetValue.

Miembros necesarios para IValueProvider

Los siguientes métodos y propiedades son necesarios para implementar IValueProvider.

Miembros necesarios	Tipo de miembro	Notas
IsReadOnlyProperty	Propiedad	Ninguno
ValueProperty	Propiedad	Ninguno
SetValue	Método	Ninguno

Excepciones

Los proveedores deben iniciar las excepciones siguientes.

Tipo de excepción	Condition
InvalidOperationException	SetValue Si la información específica de la configuración regional se pasa a un control con un formato incorrecto (por ejemplo, una fecha con un formato incorrecto).
ArgumentException	SetValue Si un nuevo valor no se puede convertir de una cadena en un formato que el control reconoce.
ElementNotEnabledException	SetValue Cuando se realiza un intento de manipular un control que no está habilitado.

InvalidOperationException

SetValue

Si la información específica de la configuración regional se pasa a un control con un formato incorrecto (por ejemplo, una fecha con un formato incorrecto).

ArgumentException

SetValue