Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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 está associado a um ou mais desses valores de estado a qualquer momento. As constantes de estado do objeto a seguir 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 seguintes sinalizadores de bits. Os clientes chamam GetStateText com o valor state para recuperar uma cadeia de caracteres localizada que descreve o estado do objeto.
Quando o estado de um objeto muda, 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 estes objetos, não utilize EVENT_OBJECT_STATECHANGE. Em vez disso, use a constante de evento individual.
A seguir estão constantes de estado de objeto:
| Constante | Descrição |
|---|---|
|
STATE_SYSTEM_ALERT_HIGH 0x10000000 |
(Esta constante de estado do objeto não é suportada.) Indica informações importantes a serem imediatamente transmitidas 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 cego 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 à vista. 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 |
(Esta constante de estado do objeto não é suportada.) 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 cego 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. O usuário pode então consultar as informações de alerta quando conveniente. |
|
STATE_SYSTEM_ALERT_LOW 0x4000000 |
(Esta constante de estado do objeto não é suportada.) 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 em sua barra de ferramentas para indicar que ele tem uma dica para o usuário. |
|
STATE_SYSTEM_ANIMATED 0x4000 |
A aparência do objeto muda rápida ou constantemente. Os 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 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 o papel 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 |
(Esta constante de estado do objeto não é suportada.) O objeto não é cortado 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 foco de objeto com seleção de objetos. 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 aplicativos cliente sobre alterações de estado. Não utilize 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 é rastreado 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á programaticamente oculto. Por exemplo, o menu itmes fica programaticamente oculto 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 devem 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 definidas. Nesse caso, o aplicativo cliente pode comunicar todos os itens na lista aos usuários. Se um aplicativo cliente estiver navegando por uma árvore de IAccessible |
|
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 rolagem ou movimentação de texto ou gráficos. |
|
STATE_SYSTEM_MIXED 0x20 |
Indica que o estado de uma caixa de seleção de três estados ou botão da barra de ferramentas não é 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 arrastá-lo para um novo local. |
|
STATE_SYSTEM_MULTISELECTABLE 0x1000000 |
Indica que o objeto aceita vários itens selecionados; ou seja, SELFLAG_ADDSELECTION para o IAccessible::accSelect método é 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 está cortado ou rolou para fora da exibição, mas não está programaticamente oculto. Se o usuário tornar a janela de visualização maior, mais do objeto será 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 seleção. |
|
STATE_SYSTEM_SELECTED 0x2 |
O objeto está selecionado. |
|
STATE_SYSTEM_SELFVOICING 0x80000 |
O objeto ou filho usa a tecnologia de conversão de texto em fala (TTS) 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 as 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. |
Requerimentos
| Exigência | Valor |
|---|---|
| Cabeçalho |
Oleacc.h |