Compatibilidad de UI Automation para el tipo de control Pane

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 proporciona información sobre la compatibilidad de UI Automation con el tipo de control Pane. En la UI Automation, un tipo de control es un conjunto de condiciones que debe cumplir un control para usar la propiedad ControlTypeProperty. Las condiciones incluyen instrucciones específicas para la estructura de árbol de UI Automation, los valores de propiedades de UI Automation y los patrones de control.

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

En las secciones siguientes se definen la estructura de árbol de UI Automation, las propiedades, los patrones de control y los eventos obligatorios para el tipo de control Pane. Los requisitos de UI Automation se aplican a todos los controles de lista, sean de Windows Presentation Foundation (WPF), Win32 o Windows Forms.

Este tema contiene las secciones siguientes.

Estructura de árbol de automatización de la interfaz de usuario obligatoria
Propiedades de automatización de la interfaz de usuario obligatorias
Patrones de control de automatización de la interfaz de usuario obligatorios
Eventos necesarios de automatización de la interfaz de usuario
Ejemplo de tipo de control de panel
Temas relacionados

Estructura de árbol de automatización de la interfaz de usuario obligatoria

En la tabla siguiente se muestra la vista de control y la vista de contenido del árbol UI Automation correspondiente a los controles de panel y se describe qué puede contener cada vista. Para obtener más información acerca del árbol de UI Automation, vea Información general sobre el árbol de la UI Automation.

Vista de control	Vista de contenido
Panel	Recuadro

Propiedades de automatización de la interfaz de usuario obligatorias

En la tabla siguiente se muestra la lista de propiedades de UI Automation cuyo valor o definición es especialmente relevante para los controles de panel. Para obtener más información acerca de las propiedades de UI Automation, vea Propiedades de UI Automation para clientes.

Propiedad de UI Automation	Valor	Notas
AutomationIdProperty	Vea las notas.	El valor de esta propiedad debe ser único en todos los controles de una aplicación.
BoundingRectangleProperty	Consulte las notas.	El rectángulo más externo que contiene el control completo.
IsKeyboardFocusableProperty	Vea las notas.	Si el control puede recibir el foco del teclado, debe admitir esta propiedad.
NameProperty	Consulte las notas.	El valor de esta propiedad siempre debe ser un título claro, conciso y significativo.
ClickablePointProperty	Consulte las notas.	Esta propiedad expone un punto del control de panel en el que se puede hacer clic que hace que el panel reciba el foco cuando se hace clic en él.
LabeledByProperty	Consulte las notas.	Normalmente, los controles de panel no tienen una etiqueta estática. Si hay una etiqueta de texto estática, se debería exponer a través de esta propiedad.
ControlTypeProperty	Panel	Este valor es el mismo para todos los marcos de trabajo de la UI.
LocalizedControlTypeProperty	"panel"	Cadena localizada que corresponde al tipo de control Pane.
IsContentElementProperty	True	Los controles de panel siempre están incluidos en la vista de contenido del árbol de UI Automation.
IsControlElementProperty	True	Los controles de panel siempre están incluidos en la vista de control del árbol de UI Automation.
HelpTextProperty	""	El texto de ayuda de los controles de panel debería explicar cuál es la finalidad del marco y cómo se relaciona con otros marcos. Se necesitará una descripción si el valor de NameProperty no aclara la finalidad y la relación de los marcos. "
AccessKeyProperty	Vea las notas.	Si una combinación de teclas concreta proporciona el foco al panel, esa información se debería exponer a través de esta propiedad.

Patrones de control de automatización de la interfaz de usuario obligatorios

En la tabla siguiente se muestra una lista de los patrones de control de UI Automation con los que deben ser compatibles todos los controles de panel. Para obtener más información acerca de los patrones de control, vea Información general acerca de los patrones de control de automatización de la interfaz de usuario.

Patrón de control	Compatibilidad	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, su control debería estar basado 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 recuadro.

Eventos necesarios de automatización de la interfaz de usuario

En la tabla siguiente se muestra una lista de los eventos de UI Automation con los que deben ser compatibles todos los controles de panel. Para obtener más información sobre los eventos, vea Información general sobre eventos de UI Automation.

Evento de UI Automation	Compatibilidad/valor	Notas
WindowClosedEvent	Nunca	Ninguno
WindowOpenedEvent	Nunca	Ninguno
AsyncContentLoadedEvent	Obligatorio	Ninguno
Evento de cambio de propiedad de BoundingRectangleProperty.	Obligatorio	Ninguno
Evento de cambio de propiedad de IsOffscreenProperty.	Necesario	Ninguno
Evento de cambio de propiedad de IsEnabledProperty.	Necesario	Ninguno
Evento de cambio de propiedad de HorizontallyScrollableProperty.	Depende	Ninguno
Evento de cambio de propiedad de HorizontalScrollPercentProperty.	Depende	Ninguno
Evento de cambio de propiedad de HorizontalViewSizeProperty.	Depende	Ninguno
Evento de cambio de propiedad de VerticalScrollPercentProperty.	Depende	Ninguno
Evento de cambio de propiedad de VerticallyScrollableProperty.	Depende	Ninguno
Evento de cambio de propiedad de VerticalViewSizeProperty.	Depende	Ninguno
Evento de cambio de propiedad de WindowVisualStateProperty.	Nunca	Ninguno
AutomationFocusChangedEvent	Obligatorio	Ninguno
StructureChangedEvent	Obligatorio	Ninguno

Ejemplo de tipo de control de panel

La imagen siguiente ilustra un control que implementa el tipo de control Pane.

Captura de pantalla de ventana de applet con dos paneles

Árbol de UI Automation: vista de control	Árbol de UI Automation: vista de contenido
Recuadro Árbol (patrón Scroll) TreeItem Recuadro Edit (patrón Scroll)	Recuadro Árbol (patrón Scroll) TreeItem …Pane Edición (patrón Scroll)