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 |
|---|---|
|
(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. |
|
(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. |
|
(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. |
|
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. |
|
El control no puede aceptar la entrada en este momento. |
|
La casilla del objeto está activada. |
|
Los elementos secundarios del objeto que tienen el rol ROLE_SYSTEM_OUTLINEITEM están ocultos. |
|
Este estado representa el botón predeterminado en una ventana. |
|
Se muestran los elementos secundarios del objeto que tienen el rol ROLE_SYSTEM_OUTLINEITEM . |
|
Indica que un objeto extiende su selección mediante SELFLAG_EXTENDSELECTION en el método IAccessible::accSelect. |
|
(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. |
|
El objeto está en la ventana activa y está listo para recibir el foco del teclado. |
|
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. |
|
Cuando se invoca, el objeto muestra un menú emergente o una ventana. |
|
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. |
|
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. |
|
Indica que el objeto tiene el formato de hipervínculo. El rol del objeto normalmente será ROLE_SYSTEM_TEXT. |
|
Indica el desplazamiento o movimiento de texto o gráficos. |
|
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 . |
|
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. |
|
Indica que el objeto acepta varios elementos seleccionados; es decir, SELFLAG_ADDSELECTION para el método IAccessible::accSelect es válido. |
|
Indica que el objeto no tiene otro estado asignado. |
|
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. |
|
Se presiona el objeto . |
|
El objeto es un control de edición protegido con contraseña. |
|
El objeto se designa de solo lectura. |
|
El objeto acepta la selección. |
|
El objeto está seleccionado. |
|
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. |
|
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. |
|
El objeto es un hipervínculo visitado (en el que un usuario ha hecho clic anteriormente). |
|
El objeto no está disponible. |
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|