Compartir a través de


Compatibilidad de UI Automation para el tipo de control Pane

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.

Este tema proporciona información sobre la compatibilidad de Automatización de la interfaz de usuario con el tipo de control Pane. 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.

El tipo de control Pane se usa para representar un objeto dentro de una ventana de documento o marco. Los usuarios pueden navegar entre controles de panel y dentro del contenido del panel actual, pero no pueden navegar entre elementos de paneles diferentes. Por tanto, los controles del panel representan un nivel de agrupación inferior a ventanas o documentos, pero superior a los controles individuales. El usuario navega entre paneles presionando TAB, F6 o CTRL+TAB, dependiendo del contexto. No se requiere ninguna navegación mediante teclado específica por el tipo de control Pane.

En las secciones siguientes se definen la estructura de árbol, las propiedades, los patrones de control y los eventos para el tipo de control Pane 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 lista, 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 panel 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, vea Información general del árbol de Automatización de la interfaz de usuario.

Vista de control Vista de contenido
Panel Panel

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 panel. Para más información sobre las propiedades de automatización de la interfaz de usuario, vea Propiedades de Automatización de la interfaz de usuario Properties 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.
IsKeyboardFocusableProperty Vea las notas. Si el control puede recibir el foco del teclado, debe admitir esta propiedad.
NameProperty Vea las notas. El valor de esta propiedad siempre debe ser un título claro, conciso y significativo.
ClickablePointProperty Vea las notas. Esta propiedad expone un punto en el que se puede hacer clic del control de panel que hace que el enfoque se sitúe en el panel cuando se hace clic en él.
LabeledByProperty Vea las notas. Los controles de panel normalmente no tienen una etiqueta estática. Si hay una etiqueta de texto estático, se debe exponer a través de esta propiedad.
ControlTypeProperty Panel Este valor es el mismo para todos los marcos de trabajo de la interfaz de usuario.
LocalizedControlTypeProperty "panel" Cadena localizada que corresponde al tipo de control Pane.
IsContentElementProperty True Los controles de panel siempre se incluyen en la vista de contenido del árbol de Automatización de la interfaz de usuario.
IsControlElementProperty True Los controles de panel siempre se incluyen en la vista de control del árbol de Automatización de la interfaz de usuario.
HelpTextProperty "" El texto de ayuda para controles de panel debería explicar cuál es el propósito del marco y cómo se relaciona con otros marcos. Se necesita una descripción si la finalidad y la relación de los marcos no está clara a partir del valor de la NameProperty. "
AccessKeyProperty Vea las notas. Si una combinación de teclas específica coloca el enfoque en el panel, dicha información debería exponerse a través de esta propiedad.

Patrones de control de Automatización de la interfaz de usuario necesarios

En la siguiente tabla se enumeran los patrones de control de Automatización de la interfaz de usuario que deben admitir todos los controles de panel. Para más información sobre los patrones de control, vea UI Automation Control Patterns Overview.

Patrón de control Soporte técnico Notas
ITransformProvider Depende Implemente este patrón de control si el control de panel se puede mover, cambiar de tamaño o girar en la pantalla.
IWindowProvider Nunca Si necesita implementar este patrón de control, el control debe basarse en el tipo de control Window .
IDockProvider Depende Implemente este patrón de control si se puede acoplar el control de panel.
IScrollProvider Depende Implemente este patrón de control si se puede desplazar el control de panel.

Eventos de Automatización de la interfaz de usuario necesarios

En la tabla siguiente se muestran los eventos de Automatización de la interfaz de usuario que deben admitir todos los controles de panel. Para más información sobre los eventos, vea UI Automation Events Overview.

Evento de automatización de la interfaz de usuario Soporte técnico/valor Notas
WindowClosedEvent Nunca None
WindowOpenedEvent Nunca None
AsyncContentLoadedEvent Obligatorio None
Evento cambiado por propiedadBoundingRectangleProperty . Obligatorio None
Evento cambiado por propiedadIsOffscreenProperty . Obligatorio None
Evento cambiado por propiedadIsEnabledProperty . Obligatorio None
Evento cambiado por propiedadHorizontallyScrollableProperty . Depende None
Evento cambiado por propiedadHorizontalScrollPercentProperty . Depende None
Evento cambiado por propiedadHorizontalViewSizeProperty . Depende None
Evento cambiado por propiedadVerticalScrollPercentProperty . Depende None
Evento cambiado por propiedadVerticallyScrollableProperty . Depende None
Evento cambiado por propiedadVerticalViewSizeProperty . Depende None
Evento cambiado por propiedadWindowVisualStateProperty . Nunca None
AutomationFocusChangedEvent Obligatorio None
StructureChangedEvent Obligatorio None

Ejemplo de tipo de control de panel

En la imagen siguiente se muestra un control que implementa el tipo de control Pane.

Screenshot of applet window with two panes

Árbol de Automatización de la interfaz de usuario: vista de control Árbol de Automatización de la interfaz de usuario: vista de contenido
  • Panel
  • Tree (patrón de desplazamiento)

    • TreeItem
    • Panel
    • Edit (patrón de desplazamiento)
- Pane
- Tree (patrón de desplazamiento)
- TreeItem
- …Pane
- Edit
- (patrón de desplazamiento)

Consulte también