Share via


Barra de título (referencia de elemento de interfaz de usuario de MSAA)

Nota

En este tema se describen los objetos title Bar con fines de referencia de elementos de interfaz de usuario de MSAA. Aquí no se describe cómo crear objetos de barra de título en varios marcos de interfaz de usuario. Consulte la documentación de referencia de API para el marco de interfaz de usuario que usa.

La barra de título de la parte superior de una ventana muestra un icono definido por la aplicación y una línea de texto. El texto especifica el nombre de la aplicación e indica el propósito de la ventana. La barra de título también permite al usuario mover la ventana mediante un mouse u otro dispositivo señalador.

Las barras de título contienen al menos tres botones pequeños que minimizan, maximizan o restauran y cierran la ventana asociada a la barra de título. Las barras de título también contienen un botón ayuda contextual. Las aplicaciones que se ejecutan en la versión Far-East del sistema operativo Windows también pueden contener botones editor de métodos de entrada (IME). Microsoft Active Accessibility expone estos botones como elementos secundarios de la barra de título.

Métodos IAccessible

Las barras de título admiten los siguientes métodos IAccessible :

Propiedades IAccessible

Las barras de título admiten las siguientes propiedades IAccessible :

Propiedad Comentarios
get_accChildCount La propiedad ChildCount es cinco. La propiedad ChildCount incluye los botones IME y Ayuda contextual incluso cuando no se muestran. Los botones que no se muestran tienen la propiedad StateSTATE_SYSTEM_INVISIBLE.
get_accDescription La propiedad Description de la propia barra de título es: "Muestra el nombre de la ventana y contiene controles para manipularla". Los botones secundarios de la barra de título tienen las siguientes descripciones:
  • "Mueve la ventana fuera de
  • "Hace que la ventana se llena
  • "Coloca un objeto minimizado o
  • "Cierra la ventana"
  • "Entra o deja contexto-
  • "Abre el teclado cuando se presiona"
get_accName La propia barra de título no admite la propiedad Name . Los botones secundarios de la barra de título tienen los nombres siguientes:
  • "Minimizar"
  • "Maximizar" o "Restaurar",
  • "Cerrar"
  • "Ayuda de contexto"
  • "IME"
get_accParent La propiedad Parent de la barra de título es la ventana principal de la aplicación ( ROLE_SYSTEM_WINDOW ) que tiene el mismo nombre de clase de ventana definido por la aplicación que la barra de título.
get_accRole La propiedad Role es ROLE_SYSTEM_TITLEBAR. Los botones secundarios de la barra de título tienen la propiedad RoleROLE_SYSTEM_PUSHBUTTON.
get_accState La propiedad State de la barra de título y los botones secundarios pueden ser una combinación de uno o varios de los valores siguientes: STATE_SYSTEM_FOCUSABLE
STATE_SYSTEM_INVISIBLE
STATE_SYSTEM_OFFSCREEN
STATE_SYSTEM_UNAVAILABLE
STATE_SYSTEM_PRESSED
get_accValue La propiedad Value es una cadena que es la misma que el texto que se muestra en la barra de título.

Notas

  • Aunque la barra de título de una aplicación tiene la marca de propiedad StateSTATE_SYSTEM_FOCUSABLE, nunca tiene la marca StateSTATE_SYSTEM_FOCUSED. Al establecer el foco en un objeto de barra de título, se centra la ventana de la aplicación.
  • Dado que el objeto de barra de título no admite get_accChild, los botones de la barra de título son elementos simples. No admiten la propia interfaz IAccessible . El objeto de barra de título proporciona información sobre estos botones secundarios.
  • Dado que las barras de título no obtienen el foco y no tienen ninguna acción predeterminada, los métodos accDoDefaultAction y get_accDefaultAction no se admiten para este control.

IAccessible (Interfaz)