Compartir a través de


Constantes de estado de objeto

En este tema se describen los valores constantes que se usan para describir el estado de los objetos en una interfaz de usuario de la aplicación. Las constantes de estado se definen en oleacc.h.

Un objeto está asociado a uno o varios de estos valores de estado en cualquier momento. No se usan las siguientes constantes de estado de objeto: STATE_SYSTEM_ALERT_HIGH, STATE_SYSTEM_ALERT_MEDIUM, STATE_SYSTEM_ALERT_LOW y STATE_SYSTEM_FLOATING.

Los clientes recuperan el estado de un objeto mediante una llamada a IAccessible::get_accState, que devuelve un entero que es una combinación de las marcas de bits siguientes. Los clientes llaman a GetStateText con el valor de estado para recuperar una cadena localizada que describe el estado del objeto.

Cuando cambia el estado de un objeto, los servidores deben llamar a NotifyWinEvent con la constante de evento EVENT_OBJECT_STATECHANGE . Sin embargo, los objetos con la STATE_SYSTEM_INVISIBLE, STATE_SYSTEM_FOCUSED y STATE_SYSTEM_ constantes de estado de objeto SELECTED tienen sus propias constantes de evento. Para estos objetos, no use EVENT_OBJECT_STATECHANGE. En su lugar, use la constante de evento individual.

A continuación se muestran constantes de estado de objeto:

Constante Descripción
STATE_SYSTEM_ALERT_HIGH
(No se admite esta constante de estado de objeto).
Indica información importante que se va a transmitir inmediatamente al usuario. Por ejemplo, cuando una batería alcanza un nivel críticomente bajo, un indicador de nivel genera una alerta de alto nivel. Como resultado, una herramienta de acceso ciego anuncia inmediatamente esta información al usuario, y un programa de ampliación de pantalla desplaza la pantalla para que el indicador de batería esté en vista. Este estado también es adecuado para cualquier solicitud u operación que se deba llevar a cabo antes de que el usuario pueda continuar.
STATE_SYSTEM_ALERT_MEDIUM
(No se admite esta constante de estado de objeto).
Indica información importante que no se transmite inmediatamente al usuario. Por ejemplo, cuando una batería empieza a alcanzar un nivel bajo, un indicador de nivel genera una alerta de nivel medio. A continuación, una herramienta de acceso ciego genera un sonido para informar al usuario de que hay información importante disponible, sin interrumpir realmente el trabajo del usuario. Después, el usuario podría consultar la información de alerta cuando sea conveniente.
STATE_SYSTEM_ALERT_LOW
(No se admite esta constante de estado de objeto).
Indica información de prioridad baja que no es importante para el usuario. Este estado se usa, por ejemplo, cuando Word cambia la apariencia del botón TipWizard en su barra de herramientas para indicar que tiene una sugerencia para el usuario.
STATE_SYSTEM_ANIMATED
La apariencia del objeto cambia rápidamente o constantemente. Los gráficos que se animan ocasionalmente se describen como ROLE_SYSTEM_GRAPHIC con la propiedad State establecida en STATE_SYSTEM_ANIMATED. Este estado se usa para indicar que la ubicación del objeto está cambiando.
STATE_SYSTEM_BUSY
El control no puede aceptar la entrada en este momento.
STATE_SYSTEM_CHECKED
La casilla del objeto está activada.
STATE_SYSTEM_COLLAPSED
Los elementos secundarios del objeto que tienen el rol ROLE_SYSTEM_OUTLINEITEM están ocultos.
STATE_SYSTEM_DEFAULT
Este estado representa el botón predeterminado en una ventana.
STATE_SYSTEM_EXPANDED
Se muestran los elementos secundarios del objeto que tienen el rol ROLE_SYSTEM_OUTLINEITEM .
STATE_SYSTEM_EXTSELECTABLE
Indica que un objeto extiende su selección mediante SELFLAG_EXTENDSELECTION en el método IAccessible::accSelect.
STATE_SYSTEM_FLOATING
(No se admite esta constante de estado de objeto).
El objeto no se recorta al límite de su objeto primario y no se mueve automáticamente cuando se mueve el elemento primario.
STATE_SYSTEM_FOCUSABLE
El objeto está en la ventana activa y está listo para recibir el foco del teclado.
STATE_SYSTEM_FOCUSED
El objeto tiene el foco del teclado. No confunda el foco del objeto con la selección de objetos. Para obtener más información, vea Propiedades y métodos de selección y enfoque. Para los objetos con este estado de objeto, envíe el EVENT_OBJECT_SHOW o EVENT_OBJECT_HIDE WinEvents para notificar a las aplicaciones cliente los cambios de estado. No use EVENT_OBJECT_STATECHANGE.
STATE_SYSTEM_HASPOPUP
Cuando se invoca, el objeto muestra un menú emergente o una ventana.
STATE_SYSTEM_HOTTRACKED
El mouse realiza un seguimiento frecuente del objeto, lo que significa que la apariencia del objeto ha cambiado para indicar que el puntero del mouse se encuentra sobre él.
STATE_SYSTEM_INVISIBLE
El objeto está oculto mediante programación. Por ejemplo, los elementos de menú se ocultan mediante programación hasta que un usuario activa el menú. Dado que los objetos con este estado no están disponibles para los usuarios, las aplicaciones cliente no deben comunicar información sobre el objeto a los usuarios. Sin embargo, si las aplicaciones cliente encuentran un objeto con este estado, deben comprobar si también se establece STATE_SYSTEM_OFFSCREEN. Si se define este segundo estado, los clientes pueden comunicar la información sobre el objeto a los usuarios. Por ejemplo, un cuadro de lista puede tener STATE_SYSTEM_INVISIBLE y STATE_SYSTEM_OFFSCREEN establecer. En este caso, la aplicación cliente puede comunicar todos los elementos de la lista a los usuarios.
Si una aplicación cliente navega por un árbol IAccessible y encuentra un objeto primario invisible, La accesibilidad activa de Microsoft no expondrá información sobre los posibles elementos secundarios del elemento primario siempre que el elemento primario sea invisible.
STATE_SYSTEM_LINKED
Indica que el objeto tiene el formato de hipervínculo. El rol del objeto normalmente será ROLE_SYSTEM_TEXT.
STATE_SYSTEM_MARQUEED
Indica el desplazamiento o movimiento de texto o gráficos.
STATE_SYSTEM_MIXED
Indica que no se determina el estado de una casilla de verificación de tres estados o un botón de barra de herramientas. La casilla no está activada ni desactivada y, por tanto, está en el tercer estado o mixto .
STATE_SYSTEM_MOVEABLE
Indica que el objeto se puede mover. Por ejemplo, un usuario puede hacer clic en la barra de título del objeto y arrastrar el objeto a una nueva ubicación.
STATE_SYSTEM_MULTISELECTABLE
Indica que el objeto acepta varios elementos seleccionados; es decir, SELFLAG_ADDSELECTION para el método IAccessible::accSelect es válido.
STATE_SYSTEM_NORMAL
Indica que el objeto no tiene otro estado asignado.
STATE_SYSTEM_OFFSCREEN
El objeto se recorta o se ha desplazado fuera de la vista, pero no está oculto mediante programación. Si el usuario hace que la ventanilla sea más grande, más del objeto estará visible en la pantalla del equipo.
STATE_SYSTEM_PRESSED
Se presiona el objeto .
STATE_SYSTEM_PROTECTED
El objeto es un control de edición protegido con contraseña.
STATE_SYSTEM_READONLY
El objeto se designa de solo lectura.
STATE_SYSTEM_SELECTABLE
El objeto acepta la selección.
STATE_SYSTEM_SELECTED
El objeto está seleccionado.
STATE_SYSTEM_SELFVOICING
El objeto o elemento secundario usa la tecnología de texto a voz (TTS) con fines de descripción. Cuando un objeto con este estado tiene el foco, una ayuda de accesibilidad basada en voz no anuncia información porque el objeto lo anuncia automáticamente.
STATE_SYSTEM_SIZEABLE
Se puede cambiar el tamaño del objeto. Por ejemplo, un usuario podría cambiar el tamaño de una ventana arrastrándolo por el borde.
STATE_SYSTEM_TRAVERSED
El objeto es un hipervínculo visitado (en el que un usuario ha hecho clic anteriormente).
STATE_SYSTEM_UNAVAILABLE
El objeto no está disponible.

Requisitos

Requisito Value
Encabezado
Oleacc.h