Compatibilidad de automatización de la interfaz de usuario para el tipo de control de posición
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 ofrece información sobre la compatibilidad de Automatización de la interfaz de usuario con el tipo de control Thumb. En Automatización de la interfaz de usuario, un tipo de control es un conjunto de condiciones que un control debe cumplir para poder usar la propiedad ControlTypeProperty. Las condiciones incluyen directrices específicas para la estructura de árbol de Automatización de la interfaz de usuario, los valores de propiedad de Automatización de la interfaz de usuario y los patrones de control.
Los controles de posición ofrecen la funcionalidad que permite que un control se mueva (o se arrastre), como un botón de barra de desplazamiento, o que cambie su tamaño, como un widget para cambiar el tamaño de una ventana. Los controles de posición también pueden implementarse como bordes movibles de paneles. Tenga en cuenta que no ofrece funcionalidad de arrastrar y colocar. Los controles de posición pueden recibir el foco del mouse, pero el foco del teclado normalmente no. El desarrollador del control debe implementar el control para que actúe correctamente (se pueda arrastrar o cambiar de tamaño).
En las secciones siguientes se definen la estructura de árbol, las propiedades, los patrones de control y los eventos para el tipo de control Thumb de Automatización de la interfaz de usuario necesarios. Los requisitos de Automatización de la interfaz de usuario se aplican a todos los controles de posición, ya sea Windows Presentation Foundation (WPF), Win32 o Windows Forms.
Estructura de árbol de Automatización de la interfaz de usuario necesaria
En la tabla siguiente se describe la vista de control y la vista de contenido del árbol de Automatización de la interfaz de usuario que pertenece a los controles de posición y se describe lo que puede incluirse en cada vista. Para más información sobre el árbol de Automatización de la interfaz de usuario, consulte Introducción al árbol de Automatización de la interfaz de usuario.
| Vista de control | Vista de contenido |
|---|---|
| Thumb | - No aplicable |
Los controles de posición nunca aparecen en la vista de contenido porque solo existen para que se manipulen con un mouse. Su funcionalidad se expone mediante otro patrón de control, como el patrón Scroll, el patrón Transform o el patrón RangeValue, que se admita en el contenedor Thumb.
Propiedades de Automatización de la interfaz de usuario necesarias
En la tabla siguiente se muestran las propiedades de Automatización de la interfaz de usuario cuyo valor o definición es especialmente relevante para los controles de posición. Para más información sobre las propiedades de Automatización de la interfaz de usuario, consulte Propiedades de Automatización de la interfaz de usuario: Propiedades para clientes.
| Propiedad de automatización de interfaz de usuario | Valor | Notas |
|---|---|---|
| AutomationIdProperty | Vea las notas. | El valor de esta propiedad debe ser único en todos los controles de una aplicación. |
| BoundingRectangleProperty | Vea las notas. | El rectángulo exterior que contiene el control completo. |
| ClickablePointProperty | Vea las notas. | Cualquier punto dentro del área de cliente visible del control Thumb. |
| IsKeyboardFocusableProperty | Vea las notas. | Si el control puede recibir el foco del teclado, debe admitir esta propiedad. |
| NameProperty | Null |
El control Thumb no está disponible en la vista de contenido del árbol de Automatización de la interfaz de usuario, por lo que no requiere un nombre. |
| LabeledByProperty | Null |
Los controles Thumb nunca tienen una etiqueta. |
| ControlTypeProperty | Thumb | Este valor es el mismo para todos los marcos de trabajo de la interfaz de usuario. |
| LocalizedControlTypeProperty | "control" | Cadena localizada que corresponde al tipo de control Thumb. |
| IsContentElementProperty | False | El control Thumb nunca es contenido. |
| IsControlElementProperty | True | El control Thumb siempre debe ser un control. |
Patrones de control de Automatización de la interfaz de usuario necesarios
En la tabla siguiente se muestran los patrones de control de Automatización de la interfaz de usuario requeridos para ser admitidos por los controles de posición. Para más información sobre los patrones de control, vea UI Automation Control Patterns Overview.
| Patrón de control/Propiedad de patrón | Soporte técnico/valor | Notas |
|---|---|---|
| ITransformProvider | Obligatorio | Permite que el control de posición se mueva por la pantalla. |
Eventos de Automatización de la interfaz de usuario necesarios
En la tabla siguiente se muestran los eventos de UI Automation que se deben admitir por parte de todos los controles de posición. Para más información sobre eventos, vea UI Automation Events Overview.
| Evento de Automatización de la interfaz de usuario | Soporte técnico | Notas |
|---|---|---|
| Evento cambiado por propiedadBoundingRectangleProperty . | Obligatorio | None |
| Evento cambiado por propiedadIsOffscreenProperty . | Obligatorio | None |
| Evento cambiado por propiedadIsEnabledProperty . | Obligatorio | None |
| AutomationFocusChangedEvent | Obligatorio | None |
| StructureChangedEvent | Obligatorio | None |