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
- Información general acerca de los patrones de control de UI Automation
- Patrones de control compatibles en un proveedor de UI Automation
- Patrones de controles de UI Automation 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 UI Automation