Constantes de estado de objeto
En este tema se describen los valores constantes usados 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 llamando 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 del 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 0x10000000 |
(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 la vista. Este estado también es adecuado para cualquier solicitud o operación que se debe completar antes de que el usuario pueda continuar. |
|
STATE_SYSTEM_ALERT_MEDIUM 0x8000000 |
(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. Una herramienta de acceso ciego genera entonces un sonido para informar al usuario de que la información importante está disponible, sin interrumpir realmente el trabajo del usuario. A continuación, el usuario podría consultar la información de alerta cuando sea conveniente. |
|
STATE_SYSTEM_ALERT_LOW 0x4000000 |
(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 0x4000 |
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 0x800 |
El control no puede aceptar la entrada en este momento. |
|
STATE_SYSTEM_CHECKED 0x10 |
La casilla del objeto está activada. |
|
STATE_SYSTEM_COLLAPSED 0x400 |
Los elementos secundarios del objeto que tienen el rol ROLE_SYSTEM_OUTLINEITEM están ocultos. |
|
STATE_SYSTEM_DEFAULT 0x100 |
Este estado representa el botón predeterminado en una ventana. |
|
STATE_SYSTEM_EXPANDED 0x200 |
Se muestran los elementos secundarios del objeto que tienen el rol ROLE_SYSTEM_OUTLINEITEM. |
|
STATE_SYSTEM_EXTSELECTABLE 0x2000000 |
Indica que un objeto extiende su selección mediante SELFLAG_EXTENDSELECTION en el método IAccessible::accSelect. |
|
STATE_SYSTEM_FLOATING 0x1000 |
(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 0x100000 |
El objeto está en la ventana activa y está listo para recibir el foco del teclado. |
|
STATE_SYSTEM_FOCUSED 0x4 |
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. En el caso de 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 0x40000000 |
Cuando se invoca, el objeto muestra un menú emergente o una ventana. |
|
STATE_SYSTEM_HOTTRACKED 0x80 |
El objeto realiza un seguimiento frecuente del mouse, lo que significa que la apariencia del objeto ha cambiado para indicar que el puntero del mouse se encuentra sobre él. |
|
STATE_SYSTEM_INVISIBLE 0x8000 |
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 de IAccessible y encuentra un objeto primario invisible, La accesibilidad activa de Microsoft no expondrá información sobre los elementos secundarios posibles del elemento primario siempre que el elemento primario sea invisible. |
|
STATE_SYSTEM_LINKED 0x400000 |
Indica que el objeto tiene el formato de hipervínculo. El rol del objeto normalmente será ROLE_SYSTEM_TEXT. |
|
STATE_SYSTEM_MARQUEED 0x2000 |
Indica el desplazamiento o movimiento de texto o gráficos. |
|
STATE_SYSTEM_MIXED 0x20 |
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 0x40000 |
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 0x1000000 |
Indica que el objeto acepta varios elementos seleccionados; es decir, SELFLAG_ADDSELECTION para el método IAccessible::accSelect es válido. |
|
STATE_SYSTEM_NORMAL 0 |
Indica que el objeto no tiene otro estado asignado. |
|
STATE_SYSTEM_OFFSCREEN 0x10000 |
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 mayor, más del objeto estará visible en la pantalla del equipo. |
|
STATE_SYSTEM_PRESSED 0x8 |
Se presiona el objeto . |
|
STATE_SYSTEM_PROTECTED 0x20000000 |
El objeto es un control de edición protegido con contraseña. |
|
STATE_SYSTEM_READONLY 0x40 |
El objeto se designa de solo lectura. |
|
STATE_SYSTEM_SELECTABLE 0x200000 |
El objeto acepta la selección. |
|
STATE_SYSTEM_SELECTED 0x2 |
El objeto está seleccionado. |
|
STATE_SYSTEM_SELFVOICING 0x80000 |
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 0x20000 |
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 0x800000 |
El objeto es un hipervínculo que ha sido visitado (en el que se ha realizado clic anteriormente) por un usuario. |
|
STATE_SYSTEM_UNAVAILABLE 0x1 |
El objeto no está disponible. |
Requisitos
| Requisito | Valor |
|---|---|
| Encabezado |
Oleacc.h |