Share via


Control de barra de herramientas (referencia de elemento de interfaz de usuario de MSAA)

Nota

En este tema se describen los objetos Control de la barra de herramientas con fines de referencia de elementos de interfaz de usuario de MSAA. No se describe cómo crear objetos De control de barra de herramientas en varios marcos de interfaz de usuario. Consulte la documentación de referencia de API para el marco de interfaz de usuario que usa.

Un control de barra de herramientas contiene botones que llevan a cabo comandos de menú y normalmente se encuentran dentro de una ventana debajo de la barra de menús.

El nombre de clase de ventana de un control de barra de herramientas es TOOLBARCLASSNAME, que se define como "ToolbarWindow32" en Commctrl.h.

Métodos IAccessible

Un control de barra de herramientas admite los siguientes métodos IAccessible :

Método Comentarios
accDoDefaultAction La propia barra de herramientas admite el método accDoDefaultAction . Para los botones de la barra de herramientas, accDoDefaultAction llama a PostMessage con el mensaje BM_CLICK para hacer clic en el botón especificado.
accHitTest
accLocation
accNavigate
accSelect

Propiedades IAccessible

Un control de barra de herramientas admite las siguientes propiedades IAccessible :

Propiedad Comentarios
get_accChild
get_accChildCount La propiedad ChildCount es el número de controles contenidos en la barra de herramientas.
get_accDefaultAction El propio objeto de barra de herramientas no tiene una propiedad DefaultAction . La propiedad DefaultAction para los botones de la barra de herramientas depende del estilo del botón de la barra de herramientas. Los botones con el estilo TBSTYLE_DROPDOWN tienen "Open" como su propiedad DefaultAction . La propiedad DefaultAction para todos los demás botones de la barra de herramientas es "Presionar".
get_accDescription
get_accFocus
get_accHelp
get_accHelpTopic
get_accKeyboardShortcut Las barras de herramientas no tienen métodos abreviados de teclado. Sin embargo, si el texto de la ventana de la barra de herramientas contiene un carácter de y comercial (&), Microsoft Active Accessibility devuelve una cadena que no es Null como la propiedad KeyboardShortcut .
get_accName La propiedad Name de la barra de herramientas se obtiene del texto de la ventana del control (o subtítulo). Este texto no se muestra con la barra de herramientas, por lo que los desarrolladores de servidores deben proporcionar texto significativo en la instrucción de definición de recursos del control para ayudar a los usuarios de utilidades de cliente a identificar el control. El texto de la ventana se puede establecer mediante la función SetWindowText .
get_accParent La propiedad Parent es una ventana ( ROLE_SYSTEM_WINDOW ) que rodea el control y tiene la misma propiedad Name y el mismo nombre de clase de ventana que el control.
get_accRole La propiedad Role es ROLE_SYSTEM_TOOLBAR.
get_accSelection
get_accState El valor de la propiedad State de la propia barra de herramientas es cero, lo que significa que el objeto está visible. Los valores posibles para la propiedad State de los botones de la barra de herramientas son: STATE_SYSTEM_INVISIBLE o
| STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_MOVEABLE | STATE_SYSTEM_FOCUSED STATE_SYSTEM_FOCUSABLE

Notas

Los botones de una barra de herramientas envían eventos EVENT_OBJECT_STATECHANGE .

IAccessible (interfaz)