Compartir a través de

Tipo de control de panel

  • Artículo

En este tema se proporciona información sobre la compatibilidad de Automatización de la interfaz de usuario de Microsoft para el tipo de control panel de.

El panel tipo de control es para regiones potencialmente desplazables que tienen contenido dispar. Se usa para representar un objeto dentro de un marco o una ventana de documento. Los usuarios pueden navegar entre controles de panel y dentro del contenido del panel actual. Los controles de panel representan un nivel de agrupación inferior a ventanas o documentos, pero por encima de controles individuales. El usuario navega entre paneles presionando TAB, F6 o CTRL+TAB, en función del contexto.

En las secciones siguientes se define la estructura de árbol de automatización de la interfaz de usuario necesaria, las propiedades, los patrones de control y los eventos para el tipo de control panel de. Los requisitos de automatización de la interfaz de usuario se aplican a todos los controles de panel en los que la plataforma o plataforma de la interfaz de usuario integra la compatibilidad de automatización de la interfaz de usuario para los tipos de control y los patrones de control.

Este tema contiene las secciones siguientes.

Estructura de árbol típica

En la tabla siguiente se muestra un control típico y una vista de contenido del árbol de automatización de la interfaz de usuario que pertenece a los controles de panel y describe lo que se puede contener en cada vista. Para obtener 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
  • Hoja
  • Hoja

 

Un control de panel siempre aparece en las vistas de control y contenido. No exponga un objeto de diseño como un panel en el control o en la vista de contenido si el objeto solo se usa para la presentación visual.

Propiedades pertinentes

En la tabla siguiente se enumeran las propiedades de automatización de la interfaz de usuario cuyo valor o definición es especialmente relevante para los controles de panel. Para obtener más información sobre las propiedades de automatización de la interfaz de usuario, consulte Recuperar propiedades de elementos de automatización de la interfaz de usuario.

Ui Automation (propiedad) Valor Notas
UIA_AccessKeyPropertyId Vea las notas. Si una combinación de teclas específica proporciona el foco al panel, esa información se debe exponer a través de esta propiedad.
UIA_AutomationIdPropertyId Vea las notas. El valor de esta propiedad debe ser único entre todos los elementos del mismo nivel en la vista sin procesar del árbol de automatización de la interfaz de usuario.
UIA_BoundingRectanglePropertyId Vea las notas. Rectángulo más externo que contiene todo el control.
UIA_ClickablePointPropertyId Vea las notas. Esta propiedad expone un punto en el que se puede hacer clic del control de panel que hace que el panel se centre cuando se hace clic en él.
UIA_ControlTypePropertyId de panel de
UIA_HelpTextPropertyId Vea las notas. El texto de ayuda de los controles de panel debe explicar el propósito del marco y cómo se relaciona con otros marcos. Una descripción es necesaria si el propósito y la relación de los fotogramas no están claros del valor de la propiedad UIA_NamePropertyId.
UIA_IsContentElementPropertyId VERDADERO El control de panel siempre se incluye en la vista de contenido del árbol de automatización de la interfaz de usuario.
UIA_IsControlElementPropertyId VERDADERO El control de panel siempre se incluye en la vista de control del árbol de automatización de la interfaz de usuario.
UIA_IsKeyboardFocusablePropertyId Vea las notas. Si el control puede recibir el foco del teclado, debe admitir esta propiedad.
UIA_LabeledByPropertyId Vea las notas. Normalmente, los controles de panel no tienen una etiqueta estática. Si hay una etiqueta de texto estático, debe exponerse a través de esta propiedad.
UIA_LocalizedControlTypePropertyId Vea las notas. Cadena localizada correspondiente al tipo de control Panel. El valor predeterminado es "panel" para en-US o inglés (Estados Unidos).
UIA_NamePropertyId Vea las notas. El valor de esta propiedad siempre debe ser un título claro, conciso y significativo.

 

Patrones de control necesarios

En la tabla siguiente se enumeran los patrones de control de automatización de la interfaz de usuario necesarios para ser compatibles con los controles de panel. Para obtener más información sobre los patrones de control, consulte Introducción a los patrones de control de automatización de la interfaz de usuario.

Patrón de control Apoyo Notas
IDockProvider Depende Implemente el patrón de control dock si se puede acoplar el control de panel.
IScrollProvider Depende Implemente el patrón de control Scroll si se puede desplazar el control de panel.
ITransformProvider Depende Implemente el patrón de control transform si el control de panel se puede mover, cambiar el tamaño o girar en la pantalla.
IWindowProvider Nunca Si el elemento necesita implementar el patrón de control Window, el control debe basarse en el tipo de control window .

 

Eventos necesarios

En la tabla siguiente se enumeran los eventos de automatización de la interfaz de usuario que son necesarios para admitir los controles de panel. Para obtener más información sobre los eventos, consulte ui Automation Events Overview.

Evento de automatización de la interfaz de usuario Notas
UIA_AsyncContentLoadedEventId
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId evento de cambio de propiedad.
UIA_IsOffscreenPropertyId evento de cambio de propiedad. Si el control admite la propiedad IsOffscreen, debe admitir este evento.
UIA_ScrollHorizontallyScrollablePropertyId evento de cambio de propiedad. Si el control admite el patrón de control Scroll, debe admitir este evento.
UIA_ScrollHorizontalScrollPercentPropertyId evento de cambio de propiedad. Si el control admite el patrón de control Scroll, debe admitir este evento.
UIA_ScrollHorizontalViewSizePropertyId evento de cambio de propiedad. Si el control admite el patrón de control Scroll, debe admitir este evento.
UIA_ScrollVerticallyScrollablePropertyId evento de cambio de propiedad. Si el control admite el patrón de control Scroll, debe admitir este evento.
UIA_ScrollVerticalScrollPercentPropertyId evento de cambio de propiedad. Si el control admite el patrón de control Scroll, debe admitir este evento.
UIA_ScrollVerticalViewSizePropertyId evento de cambio de propiedad. Si el control admite el patrón de control Scroll, debe admitir este evento.
UIA_StructureChangedEventId

 

Ejemplo de tipo de control de panel

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

captura de pantalla de que muestra un ejemplo de de control de panel

Árbol de automatización de la interfaz de usuario: vista de control Árbol de automatización de la interfaz de usuario: vista de contenido
  • Hoja
    • Árbol (patrón de desplazamiento)
      • TreeItem
      • ...
  • Hoja
    • Editar (patrón de desplazamiento)
  • Hoja
    • Árbol (patrón de desplazamiento)
      • TreeItem
      • ...
    • Hoja
      • Editar (patrón de desplazamiento)

 

conceptual de

Introducción a los tipos de control de automatización de la interfaz de usuario de

información general de automatización de la interfaz de usuario de