Constantes de estado do objeto

Este tópico descreve os valores constantes usados para descrever o estado dos objetos em uma interface do usuário do aplicativo. As constantes de estado são definidas em oleacc.h.

Um objeto é associado a um ou mais desses valores de estado a qualquer momento. As seguintes constantes de estado de objeto não são usadas: STATE_SYSTEM_ALERT_HIGH, STATE_SYSTEM_ALERT_MEDIUM, STATE_SYSTEM_ALERT_LOW e STATE_SYSTEM_FLOATING.

Os clientes recuperam o estado de um objeto chamando IAccessible::get_accState, que retorna um inteiro que é uma combinação dos sinalizadores de bit a seguir. Os clientes chamam GetStateText com o valor de estado para recuperar uma cadeia de caracteres localizada que descreve o estado do objeto.

Quando o estado de um objeto é alterado, os servidores devem chamar NotifyWinEvent com a constante de evento EVENT_OBJECT_STATECHANGE. No entanto, objetos com as constantes de estado de objeto STATE_SYSTEM_INVISIBLE, STATE_SYSTEM_FOCUSED e STATE_SYSTEM_ SELECTED têm suas próprias constantes de evento. Para esses objetos, não use EVENT_OBJECT_STATECHANGE. Em vez disso, use a constante de evento individual.

Veja a seguir as constantes de estado do objeto:

Constante	Descrição
STATE_SYSTEM_ALERT_HIGH 0x10000000	(Não há suporte para essa constante de estado de objeto.) Indica informações importantes a serem transmitidas imediatamente ao usuário. Por exemplo, quando uma bateria atinge um nível criticamente baixo, um indicador de nível gera um alerta de alto nível. Como resultado, uma ferramenta de acesso às cegas anuncia imediatamente essas informações ao usuário e um programa de ampliação de tela rola a tela para que o indicador de bateria esteja em exibição. Esse estado também é apropriado para qualquer prompt ou operação que deve ser concluída antes que o usuário possa continuar.
STATE_SYSTEM_ALERT_MEDIUM 0x8000000	(Não há suporte para essa constante de estado de objeto.) Indica informações importantes que não são transmitidas imediatamente ao usuário. Por exemplo, quando uma bateria está começando a atingir um nível baixo, um indicador de nível gera um alerta de nível médio. Uma ferramenta de acesso às cegas gera um som para que o usuário saiba que informações importantes estão disponíveis, sem realmente interromper o trabalho do usuário. Em seguida, o usuário pode consultar as informações de alerta quando conveniente.
STATE_SYSTEM_ALERT_LOW 0x4000000	(Não há suporte para essa constante de estado de objeto.) Indica informações de baixa prioridade que não são importantes para o usuário. Esse estado é usado, por exemplo, quando o Word altera a aparência do botão TipWizard na barra de ferramentas para indicar que ele tem uma dica para o usuário.
STATE_SYSTEM_ANIMATED 0x4000	A aparência do objeto muda rapidamente ou constantemente. Gráficos que são animados ocasionalmente são descritos como ROLE_SYSTEM_GRAPHIC com a propriedade State definida como STATE_SYSTEM_ANIMATED. Esse estado é usado para indicar que a localização do objeto está mudando.
STATE_SYSTEM_BUSY 0x800	O controle não pode aceitar a entrada no momento.
STATE_SYSTEM_CHECKED 0x10	A caixa de seleção do objeto está marcada.
STATE_SYSTEM_COLLAPSED 0x400	Os filhos do objeto que têm a função ROLE_SYSTEM_OUTLINEITEM estão ocultos.
STATE_SYSTEM_DEFAULT 0x100	Esse estado representa o botão padrão em uma janela.
STATE_SYSTEM_EXPANDED 0x200	Os filhos do objeto que têm a função ROLE_SYSTEM_OUTLINEITEM são exibidos.
STATE_SYSTEM_EXTSELECTABLE 0x2000000	Indica que um objeto estende sua seleção usando SELFLAG_EXTENDSELECTION no método IAccessible::accSelect.
STATE_SYSTEM_FLOATING 0x1000	(Não há suporte para essa constante de estado de objeto.) O objeto não é recortado ao limite de seu objeto pai e não se move automaticamente quando o pai se move.
STATE_SYSTEM_FOCUSABLE 0x100000	O objeto está na janela ativa e está pronto para receber o foco do teclado.
STATE_SYSTEM_FOCUSED 0x4	O objeto tem o foco do teclado. Não confunda o foco do objeto com a seleção de objeto. Para obter mais informações, consulte propriedades e métodos de seleção e foco. Para objetos com esse estado de objeto, envie o EVENT_OBJECT_SHOW ou EVENT_OBJECT_HIDE WinEvents para notificar os aplicativos cliente sobre alterações de estado. Não use EVENT_OBJECT_STATECHANGE.
STATE_SYSTEM_HASPOPUP 0x40000000	Quando invocado, o objeto exibe um menu pop-up ou uma janela.
STATE_SYSTEM_HOTTRACKED 0x80	O objeto é controlado pelo mouse, o que significa que a aparência do objeto foi alterada para indicar que o ponteiro do mouse está localizado sobre ele.
STATE_SYSTEM_INVISIBLE 0x8000	O objeto está oculto programaticamente. Por exemplo, as mensagens de menu ficam ocultas programaticamente até que um usuário ative o menu. Como os objetos com esse estado não estão disponíveis para os usuários, os aplicativos cliente não devem comunicar informações sobre o objeto aos usuários. No entanto, se os aplicativos cliente encontrarem um objeto com esse estado, eles deverão verificar se STATE_SYSTEM_OFFSCREEN também está definido. Se esse segundo estado for definido, os clientes poderão comunicar as informações sobre o objeto aos usuários. Por exemplo, uma caixa de listagem pode ter STATE_SYSTEM_INVISIBLE e STATE_SYSTEM_OFFSCREEN definidos. Nesse caso, o aplicativo cliente pode comunicar todos os itens da lista aos usuários. Se um aplicativo cliente estiver navegando por uma árvore IAccessible e encontrar um objeto pai invisível, o Microsoft Active Accessibility não exporá informações sobre possíveis filhos do pai, desde que o pai seja invisível.
STATE_SYSTEM_LINKED 0x400000	Indica que o objeto está formatado como um hiperlink. A função do objeto geralmente será ROLE_SYSTEM_TEXT.
STATE_SYSTEM_MARQUEED 0x2000	Indica a rolagem ou a movimentação de texto ou elementos gráficos.
STATE_SYSTEM_MIXED 0x20	Indica que o estado de uma caixa de seleção de três estados ou botão de barra de ferramentas não está determinado. A caixa de seleção não está marcada nem desmarcada e, portanto, está no terceiro ou estado de misto.
STATE_SYSTEM_MOVEABLE 0x40000	Indica que o objeto pode ser movido. Por exemplo, um usuário pode clicar na barra de título do objeto e arrastar o objeto para um novo local.
STATE_SYSTEM_MULTISELECTABLE 0x1000000	Indica que o objeto aceita vários itens selecionados; ou seja, SELFLAG_ADDSELECTION para o método IAccessible::accSelect é válido.
STATE_SYSTEM_NORMAL 0	Indica que o objeto não tem outro estado atribuído a ele.
STATE_SYSTEM_OFFSCREEN 0x10000	O objeto é recortado ou rolado para fora do modo de exibição, mas não está oculto programaticamente. Se o usuário aumentar o visor, mais do objeto ficará visível na tela do computador.
STATE_SYSTEM_PRESSED 0x8	O objeto é pressionado.
STATE_SYSTEM_PROTECTED 0x20000000	O objeto é um controle de edição protegido por senha.
STATE_SYSTEM_READONLY 0x40	O objeto é designado somente leitura.
STATE_SYSTEM_SELECTABLE 0x200000	O objeto aceita a seleção.
STATE_SYSTEM_SELECTED 0x2	O objeto está selecionado.
STATE_SYSTEM_SELFVOICING 0x80000	O objeto ou filho usa a tecnologia TTS (conversão de texto em fala) para fins de descrição. Quando um objeto com esse estado tem o foco, um auxílio de acessibilidade baseado em fala não anuncia informações porque o objeto o anuncia automaticamente.
STATE_SYSTEM_SIZEABLE 0x20000	O objeto pode ser redimensionado. Por exemplo, um usuário pode alterar o tamanho de uma janela arrastando-a pela borda.
STATE_SYSTEM_TRAVERSED 0x800000	O objeto é um hiperlink que foi visitado (clicado anteriormente) por um usuário.
STATE_SYSTEM_UNAVAILABLE 0x1	O objeto não está disponível.

Requisitos

Requisito	Valor
Cabeçalho	Oleacc.h