Compartilhar via


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 do 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 o STATE_SYSTEM_INVISIBLE, STATE_SYSTEM_FOCUSED e STATE_SYSTEM_ constantes de estado do objeto 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
(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 é adequado para qualquer prompt ou operação que deve ser concluída antes que o usuário possa continuar.
STATE_SYSTEM_ALERT_MEDIUM
(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. Em seguida, 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 for conveniente.
STATE_SYSTEM_ALERT_LOW
(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 Word altera a aparência do botão TipWizard em sua barra de ferramentas para indicar que ele tem uma dica para o usuário.
STATE_SYSTEM_ANIMATED
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 o local do objeto está mudando.
STATE_SYSTEM_BUSY
O controle não pode aceitar a entrada no momento.
STATE_SYSTEM_CHECKED
A caixa de marcar do objeto está selecionada.
STATE_SYSTEM_COLLAPSED
Os filhos do objeto que têm a função ROLE_SYSTEM_OUTLINEITEM estão ocultos.
STATE_SYSTEM_DEFAULT
Esse estado representa o botão padrão em uma janela.
STATE_SYSTEM_EXPANDED
Os filhos do objeto que têm a função ROLE_SYSTEM_OUTLINEITEM são exibidos.
STATE_SYSTEM_EXTSELECTABLE
Indica que um objeto estende sua seleção usando SELFLAG_EXTENDSELECTION no método IAccessible::accSelect.
STATE_SYSTEM_FLOATING
(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
O objeto está na janela ativa e está pronto para receber o foco do teclado.
STATE_SYSTEM_FOCUSED
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
Quando invocado, o objeto exibe um menu pop-up ou uma janela.
STATE_SYSTEM_HOTTRACKED
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
O objeto é ocultado 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 marcar 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, a Acessibilidade Ativa da Microsoft não exporá informações sobre possíveis filhos do pai, desde que o pai seja invisível.
STATE_SYSTEM_LINKED
Indica que o objeto é formatado como um hiperlink. A função do objeto geralmente será ROLE_SYSTEM_TEXT.
STATE_SYSTEM_MARQUEED
Indica rolagem ou movimentação de texto ou elementos gráficos.
STATE_SYSTEM_MIXED
Indica que o estado de uma caixa de marcar de três estados ou o botão da barra de ferramentas não está determinado. A caixa marcar não está selecionada nem desmarcada e, portanto, está no terceiro estado ou misto.
STATE_SYSTEM_MOVEABLE
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
Indica que o objeto aceita vários itens selecionados; ou seja, SELFLAG_ADDSELECTION para o método IAccessible::accSelect é válido.
STATE_SYSTEM_NORMAL
Indica que o objeto não tem outro estado atribuído a ele.
STATE_SYSTEM_OFFSCREEN
O objeto é recortado ou foi rolado para fora do modo de exibição, mas não está oculta programaticamente. Se o usuário aumentar o visor, mais do objeto ficará visível na tela do computador.
STATE_SYSTEM_PRESSED
O objeto é pressionado.
STATE_SYSTEM_PROTECTED
O objeto é um controle de edição protegido por senha.
STATE_SYSTEM_READONLY
O objeto é designado somente leitura.
STATE_SYSTEM_SELECTABLE
O objeto aceita a seleção.
STATE_SYSTEM_SELECTED
O objeto está selecionado.
STATE_SYSTEM_SELFVOICING
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
O objeto pode ser redimensionado. Por exemplo, um usuário pode alterar o tamanho de uma janela arrastando-o pela borda.
STATE_SYSTEM_TRAVERSED
O objeto é um hiperlink que foi visitado (clicado anteriormente) por um usuário.
STATE_SYSTEM_UNAVAILABLE
O objeto não está disponível.

Requisitos

Requisito Valor
parâmetro
Oleacc.h