Roles de objeto

En este tema se describen los valores constantes usados para describir los roles de varios objetos de interfaz de usuario en una aplicación. Las constantes de rol se definen en el archivo Oleacc.h.

Debe usar solo las constantes de rol enumeradas aquí; no agregue roles o roles personalizados que no estén predefinidos.

Antes de usar estos roles de objeto, los desarrolladores de aplicaciones cliente deben usar la herramienta Inspect para comprobar que los elementos de la interfaz de usuario usan los roles de objeto.

Para recuperar el rol de un objeto, los clientes llaman al método IAccessible::get_accRole , que debe devolver uno de los valores descritos en la tabla. Para recuperar una cadena localizada que describe el rol del objeto, los clientes llaman a la función GetRoleText con el valor del rol. Las cadenas localizadas para los valores de rol se encuentran en el archivo oleaccrc.dll.

Constante	Descripción
ROLE_SYSTEM_ALERT	El objeto representa una alerta o una condición sobre la que se debe notificar a un usuario. Este rol solo se usa para objetos que incorporan una alerta, pero no están asociados a otro elemento de interfaz de usuario, como un cuadro de mensaje, un gráfico, un texto o un sonido.
ROLE_SYSTEM_ANIMATION	El objeto representa un control de animación cuyo contenido cambia con el tiempo, como un control que muestra una serie de fotogramas de mapa de bits. Los controles de animación se muestran cuando se copian archivos o cuando se realiza alguna otra tarea que consume mucho tiempo.
ROLE_SYSTEM_APPLICATION	El objeto representa una ventana principal de una aplicación.
ROLE_SYSTEM_BORDER	El objeto representa un borde de ventana. Todo el borde se representa mediante un único objeto en lugar de por objetos independientes para cada lado.
ROLE_SYSTEM_BUTTONDROPDOWN	El objeto representa un botón que expande una lista de elementos.
ROLE_SYSTEM_BUTTONDROPDOWNGRID	El objeto representa un botón que expande una cuadrícula.
ROLE_SYSTEM_BUTTONMENU	El objeto representa un botón que expande un menú.
ROLE_SYSTEM_CARET	El objeto representa el símbolo de intercalación del sistema.
ROLE_SYSTEM_CELL	El objeto representa una celda dentro de una tabla.
ROLE_SYSTEM_CHARACTER	El objeto representa un objeto gráfico similar a un dibujo animado, como el Asistente de Microsoft Office, que se muestra para proporcionar ayuda a los usuarios de una aplicación.
ROLE_SYSTEM_CHART	El objeto representa una imagen gráfica utilizada para representar los datos del gráfico.
ROLE_SYSTEM_CHECKBUTTON	El objeto representa un control de casilla: una opción seleccionada o desactivada independientemente de otras opciones.
ROLE_SYSTEM_CLIENT	El objeto representa el área cliente de una ventana. La accesibilidad activa de Microsoft usa este rol como valor predeterminado si hay alguna pregunta sobre el rol de un elemento de interfaz de usuario.
ROLE_SYSTEM_CLOCK	El objeto representa un control que muestra la hora.
ROLE_SYSTEM_COLUMN	El objeto representa una columna de celdas dentro de una tabla.
ROLE_SYSTEM_COLUMNHEADER	El objeto representa un encabezado de columna, proporcionando una etiqueta visual para una columna de una tabla.
ROLE_SYSTEM_COMBOBOX	El objeto representa un cuadro combinado: un control de edición con un cuadro de lista asociado que proporciona un conjunto de opciones predefinidas.
ROLE_SYSTEM_CURSOR	El objeto representa el puntero del mouse del sistema.
ROLE_SYSTEM_DIAGRAM	El objeto representa una imagen gráfica que se usa para diagramar datos.
ROLE_SYSTEM_DIAL	El objeto representa un marcador o una perilla.
ROLE_SYSTEM_DIALOG	El objeto representa un cuadro de diálogo o un cuadro de mensaje.
ROLE_SYSTEM_DOCUMENT	El objeto representa una ventana de documento. Una ventana de documento siempre se encuentra dentro de una ventana de aplicación. Este rol solo se aplica a las ventanas MDI y hace referencia al objeto que contiene la barra de título de MDI.
ROLE_SYSTEM_DROPLIST	El objeto representa el control de calendario SysDateTimePick32. El componente en tiempo de ejecución de accesibilidad activa de Microsoft usa este rol para indicar que se ha encontrado una fecha o un control de calendario.
ROLE_SYSTEM_EQUATION	El objeto representa una ecuación matemática.
ROLE_SYSTEM_GRAPHIC	El objeto representa una imagen.
ROLE_SYSTEM_GRIP	El objeto representa un puntero especial del mouse que permite a un usuario manipular elementos de interfaz de usuario como ventanas. Un ejemplo de esto implica cambiar el tamaño de una ventana arrastrando su esquina inferior derecha.
ROLE_SYSTEM_GROUPING	El objeto agrupa lógicamente otros objetos. No siempre hay una relación de elementos primarios y secundarios entre el objeto de agrupación y los objetos que contiene.
ROLE_SYSTEM_HELPBALLOON	El objeto muestra un tema de ayuda en forma de información sobre herramientas o globo de ayuda.
ROLE_SYSTEM_HOTKEYFIELD	El objeto representa un campo de método abreviado de teclado que permite al usuario escribir una combinación o secuencia de pulsaciones de teclas.
ROLE_SYSTEM_INDICATOR	El objeto representa un indicador, como un gráfico de puntero, que apunta al elemento actual.
ROLE_SYSTEM_IPADDRESS	El objeto representa un control de edición diseñado para una dirección IP. El control de edición se divide en secciones, cada una para una parte específica de la dirección IP.
ROLE_SYSTEM_LINK	El objeto representa un vínculo a otra cosa. Este objeto puede tener la apariencia de un texto o un gráfico, pero actúa como un botón.
ROLE_SYSTEM_LIST	El objeto representa un cuadro de lista, lo que permite al usuario seleccionar uno o varios elementos.
ROLE_SYSTEM_LISTITEM	El objeto representa un elemento en un cuadro de lista o en la parte de lista de un cuadro combinado, un cuadro de lista desplegable o un cuadro combinado desplegable.
ROLE_SYSTEM_MENUBAR	El objeto representa la barra de menús (situada debajo de la barra de título de una ventana) desde la que los usuarios seleccionan menús.
ROLE_SYSTEM_MENUITEM	El objeto representa un elemento de menú: una entrada de menú que el usuario puede elegir para llevar a cabo un comando, seleccionar una opción o mostrar otro menú. Funcionalmente, un elemento de menú es equivalente a un botón de pulsación, un botón de radio, una casilla o un menú.
ROLE_SYSTEM_MENUPOPUP	El objeto representa un menú: una lista de opciones, cada una con una acción específica. Todos los tipos de menú deben tener rol, incluidos los menús desplegables que se muestran cuando se seleccionan en una barra de menús; y menús contextuales, que se muestran haciendo clic en el botón derecho del mouse.
ROLE_SYSTEM_OUTLINE	El objeto representa un esquema o una estructura de árbol, como un control de vista de árbol, que muestra una lista jerárquica y permite al usuario expandir y contraer ramas.
ROLE_SYSTEM_OUTLINEBUTTON	El objeto representa un elemento que navega como un elemento de esquema. Las teclas flecha arriba y abajo se usan para navegar por el contorno. Sin embargo, en lugar de expandirse y contraerse cuando se presiona la tecla FLECHA IZQUIERDA y DERECHA, estos menús se expanden o contraen cuando se presiona la tecla SPACEBAR o ENTRAR y el elemento tiene el foco.
ROLE_SYSTEM_OUTLINEITEM	El objeto representa un elemento en una estructura de esquema o árbol.
ROLE_SYSTEM_PAGETAB	El objeto representa una pestaña de página. El único elemento secundario de un control de pestaña de página es un objeto ROLE_SYSTEM_GROUPING que tiene el contenido de la página asociada.
ROLE_SYSTEM_PAGETABLIST	El objeto representa un contenedor de controles de pestaña de página.
ROLE_SYSTEM_PANE	El objeto representa un panel dentro de un marco o una ventana de documento. Los usuarios pueden navegar entre paneles y dentro del contenido del panel actual, pero no pueden navegar entre elementos de paneles distintos. Por lo tanto, los paneles representan un nivel de agrupación inferior a marcos o ventanas de documento, pero superior a los controles individuales. El usuario navega entre paneles presionando TAB, F6 o CTRL+TAB, dependiendo del contexto.
ROLE_SYSTEM_PROGRESSBAR	El objeto representa una barra de progreso, que muestra dinámicamente la cantidad de una operación en curso completada. Este control no toma ninguna entrada del usuario.
ROLE_SYSTEM_PROPERTYPAGE	El objeto representa una hoja de propiedades.
ROLE_SYSTEM_PUSHBUTTON	El objeto representa un control de botón de inserción.
ROLE_SYSTEM_RADIOBUTTON	El objeto representa un botón de opción (anteriormente, un botón de radio). Es uno de un grupo de opciones mutuamente excluyentes. Se supone que todos los objetos que comparten el mismo elemento primario y que tienen este atributo forman parte de un único grupo mutuamente excluyente. Para dividir estos objetos en grupos independientes, use ROLE_SYSTEM_GROUPING objetos .
ROLE_SYSTEM_ROW	El objeto representa una fila de celdas dentro de una tabla.
ROLE_SYSTEM_ROWHEADER	El objeto representa un encabezado de fila, que proporciona una etiqueta visual para una fila de tabla.
ROLE_SYSTEM_SCROLLBAR	El objeto representa una barra de desplazamiento vertical u horizontal, que forma parte del área de cliente o se usa en un control .
ROLE_SYSTEM_SEPARATOR	El objeto se usa para dividir visualmente un espacio en dos regiones. Algunos ejemplos de objetos separadores incluyen un elemento de menú separador y una barra que divide paneles divididos dentro de una ventana.
ROLE_SYSTEM_SLIDER	El objeto representa un control deslizante, que permite al usuario ajustar una configuración en incrementos concretos entre los valores mínimo y máximo.
ROLE_SYSTEM_SOUND	El objeto representa un sonido del sistema, que está asociado a varios eventos del sistema.
ROLE_SYSTEM_SPINBUTTON	El objeto representa un cuadro de número, que es un control que permite al usuario incrementar o disminuir el valor mostrado en un control "amigo" independiente asociado al cuadro de número.
ROLE_SYSTEM_SPLITBUTTON	El objeto representa un botón de una barra de herramientas que tiene un icono de lista desplegable que está directamente adyacente al botón.
ROLE_SYSTEM_STATICTEXT	El objeto representa texto de solo lectura, como etiquetas para otros controles o instrucciones en un cuadro de diálogo. El texto estático no se puede modificar ni seleccionar.
ROLE_SYSTEM_STATUSBAR	El objeto representa una barra de estado, que es un área en la parte inferior de una ventana y que muestra información sobre la operación actual, el estado de la aplicación o el objeto seleccionado. La barra de estado tiene varios campos, que muestran diferentes tipos de información.
ROLE_SYSTEM_TABLE	El objeto representa una tabla que contiene filas y columnas de celdas y, opcionalmente, encabezados de fila y encabezados de columna.
ROLE_SYSTEM_TEXT	El objeto representa texto seleccionable que permite modificaciones o se designa como de solo lectura.
ROLE_SYSTEM_TITLEBAR	El objeto representa un título o una barra de subtítulo para una ventana.
ROLE_SYSTEM_TOOLBAR	El objeto representa una barra de herramientas, que es una agrupación de controles que proporciona fácil acceso a las características usadas con frecuencia.
ROLE_SYSTEM_TOOLTIP	El objeto representa una información sobre herramientas que proporciona sugerencias útiles.
ROLE_SYSTEM_WHITESPACE	El objeto representa el espacio en blanco entre otros objetos.
ROLE_SYSTEM_WINDOW	El objeto representa el marco de ventana, que contiene objetos secundarios, como una barra de título, un cliente y otros objetos de una ventana.

Requisitos

Requisito	Value
Encabezado	Oleacc.h