Implementar el patrón de control Toggle de UI Automation

Nota:

Esta documentación está pensada para desarrolladores de .NET Framework que desean usar las clases de automatización de la interfaz de usuario administradas definidas en el espacio de nombres System.Windows.Automation. Para obtener la información más reciente sobre la automatización de la interfaz de usuario, consulte API de Windows Automation: Automatización de la interfaz de usuario.

En este tema se presentan instrucciones y convenciones para implementar IToggleProvider, incluida la información sobre métodos y propiedades. Los vínculos a referencias adicionales se enumeran al final del tema.

El TogglePattern patrón de control se usa para admitir controles que pueden recorrer un conjunto de estados y mantener un estado una vez establecido. Para obtener ejemplos de controles que implementan este patrón de control, consulte Asignación de patrones de control para clientes de automatización de la interfaz de usuario.

Directrices y convenciones de implementación

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

• Los controles que no mantienen el estado cuando se activan, como botones, botones de barra de herramientas e hipervínculos, deben implementarse IInvokeProvider en su lugar.

• Un control debe recorrer sus ToggleState en el siguiente orden: On, Off y, si se admite, Indeterminate.

• TogglePattern no ofrece un método SetState(newState) debido a problemas relacionados con la configuración directa de una CheckBox de tres estados sin recorrer su secuencia ToggleState correspondiente.

• El control RadioButton no implementa IToggleProvider, ya que no es capaz de alternar entre sus estados válidos.

Miembros necesarios para IToggleProvider

Se requieren las siguientes propiedades y métodos para implementar IToggleProvider.

Miembro requerido	Tipo de miembro	Notas
Toggle	Método	Ninguno
ToggleStateProperty	Propiedad	Ninguno

Este patrón de control no tiene eventos asociados.

Excepciones

Este patrón de control no tiene excepciones asociadas.

Consulte también

• Información general acerca de los patrones de control de UI Automation
• Patrones de control compatibles en un proveedor de UI Automation
• Patrones de control de automatización de la interfaz de usuario para clientes
• Obtener el estado de alternancia de una casilla mediante UI Automation
• Información general sobre el árbol de la UI Automation
• Utilizar el almacenamiento en caché en la automatización de la interfaz de usuario