Implementar el patrón de control Toggle 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 IToggleProvider, incluida la información acerca de métodos y propiedades. Los vínculos a referencias adicionales se enumeran al final del tema.

El TogglePattern patrón de control se utiliza para admitir controles que pueden recorrer cíclicamente un conjunto de estados y mantener un estado cuando se ha establecido. Para obtener de ejemplos de controles que implementan este patrón de control, consulte 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 IToggleProvider
Excepciones
Temas relacionados

Directrices y convenciones de implementación

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

Los controles que no conservan su estado cuando se activan, tales como botones, botones de barra de herramientas o hipervínculos, deben implementar IInvokeProvider, en lugar de Toggle.
Un control debe recorrer cíclicamente los estados ToggleState en el orden siguiente: On, Off y, si se admite, Indeterminate.
TogglePattern no proporciona un método SetState(newState) debido a los problemas que plantea establecer directamente el valor de un control CheckBox sin recorrer su secuencia de estados ToggleState correcta.
El control RadioButton no implementa IToggleProvider, porque no es capaz de recorrer cíclicamente sus estados válidos.