Compartir a través de


Implementar el patrón de control Toggle de UI Automation

Nota

Esta documentación está dirigida a los desarrolladores de .NET Framework que quieran usar las clases de automatización de la interfaz de usuario administradas definidas en el espacio de nombres System.Windows.Automation. Para ver la información más reciente acerca de la automatización de la interfaz de usuario, consulte Windows Automation API: automatización de la interfaz de usuario.

En este tema se presentan las directrices y convenciones para implementar IToggleProvider, incluida la información sobre métodos y propiedades. Al final del tema se ofrecen vínculos a referencias adicionales.

El patrón de control TogglePattern 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, vea Control Pattern Mapping for UI Automation Clients.

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 implementar IInvokeProvider en su lugar.

  • Un control debe recorrer su 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 recorrer sus estados válidos.

Miembros requeridos para IToggleProvider

Para implementar IToggleProvider, se requieren las siguientes propiedades y métodos.

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

Este patrón de control no tiene eventos asociados.

Excepciones

Este patrón de control no tiene excepciones asociadas.

Consulte también