Constantes SELFLAG

Este tópico descreve os valores constantes usados para especificar como um objeto acessível se torna selecionado ou assume o foco. As constantes são definidas em oleacc.h e são usadas com o método IAccessible::accSelect .

As seguintes combinações não são permitidas:

  • SELFLAG_ADDSELECTION | SELFLAG_REMOVESELECTION
  • SELFLAG_ADDSELECTION | SELFLAG_TAKESELECTION
  • SELFLAG_REMOVESELECTION | SELFLAG_TAKESELECTION
  • SELFLAG_EXTENDSELECTION | SELFLAG_TAKESELECTION

Observação aos clientes: A Acessibilidade Ativa da Microsoft não dá suporte à seleção do texto contido em controles de edição e edição avançada porque o texto é exposto como uma cadeia de caracteres na propriedade Value do objeto.

Para obter informações sobre como executar operações de seleção complexas, consulte Selecionando objetos filho.

Constante/valor Descrição
SELFLAG_NONE
0
Não executa nenhuma ação. A Acessibilidade Ativa da Microsoft não altera a seleção nem o foco.
SELFLAG_TAKEFOCUS
0x1
Define o foco para o objeto e o torna a âncora de seleção. Usado por si só, esse sinalizador não altera a seleção. O efeito é semelhante a mover o foco manualmente pressionando uma tecla ARROW enquanto mantém pressionada a tecla CTRL no Windows Explorer ou em qualquer caixa de listagem de seleção múltipla.
Com objetos que têm o STATE_SYSTEM_MULTISELECTABLE, SELFLAG_TAKEFOCUS é combinado com os seguintes valores:
  • SELFLAG_TAKESELECTION
  • SELFLAG_EXTENDSELECTION
  • SELFLAG_ADDSELECTION
  • SELFLAG_REMOVESELECTION
  • SELFLAG_ADDSELECTION
  • SELFLAG_EXTENDSELECTION
  • SELFLAG_REMOVESELECTION
  • SELFLAG_EXTENDSELECTION
Se você chamar IAccessible::accSelect com o sinalizador SELFLAG_TAKEFOCUS em um objeto que tenha um HWND, o sinalizador entrará em vigor somente se o pai do objeto já tiver o foco.
SELFLAG_TAKESELECTION
0x2
Seleciona o objeto e remove a seleção de todos os outros objetos no contêiner.
A menos que seja combinado com SELFLAG_TAKEFOCUS, esse sinalizador não altera o foco nem a âncora de seleção. A combinação SELFLAG_TAKESELECTION/SELFLAG_TAKEFOCUS é equivalente a clicar um item no Windows Explorer.
Esse sinalizador não deve ser combinado com os seguintes sinalizadores:
  • SELFLAG_ADDSELECTION
  • SELFLAG_REMOVESELECTION
  • SELFLAG_EXTENDSELECTION
SELFLAG_EXTENDSELECTION
0x4
Altera a seleção para que todos os objetos entre a âncora de seleção e esse objeto assumam o estado de seleção do objeto de âncora. Se o objeto de âncora não for selecionado, os objetos serão removidos da seleção. Se o objeto de âncora estiver selecionado, a seleção será estendida para incluir esse objeto e todos os objetos no meio. Defina o estado de seleção combinando esse sinalizador com SELFLAG_ADDSELECTION ou SELFLAG_REMOVESELECTION.
A menos que seja combinado com SELFLAG_TAKEFOCUS, esse sinalizador não altera o foco nem a âncora de seleção. A combinação SELFLAG_EXTENDSELECTION/SELFLAG_TAKEFOCUS é equivalente a adicionar um item a uma seleção manualmente mantendo pressionada a tecla SHIFT e clicando em um objeto não selecionado no Windows Explorer.
Esse sinalizador não é combinado com SELFLAG_TAKESELECTION.
SELFLAG_ADDSELECTION
0x8
Adiciona o objeto à seleção atual; o resultado possível é uma seleção não contígua.
A menos que seja combinado com SELFLAG_TAKEFOCUS, esse sinalizador não altera o foco nem a âncora de seleção. A combinação SELFLAG_ADDSELECTION/SELFLAG_TAKEFOCUS é equivalente a adicionar um item a uma seleção manualmente mantendo pressionada a tecla CTRL e clicando em um objeto não selecionado no Windows Explorer.
Esse sinalizador não é combinado com SELFLAG_REMOVESELECTION ou SELFLAG_TAKESELECTION.
SELFLAG_REMOVESELECTION
0x10
Remove o objeto da seleção atual; o resultado possível é uma seleção não contígua.
A menos que seja combinado com SELFLAG_TAKEFOCUS, esse sinalizador não altera o foco nem a âncora de seleção. A combinação SELFLAG_REMOVESELECTION/SELFLAG_TAKEFOCUS é equivalente a remover um item de uma seleção manualmente, mantendo pressionada a tecla CTRL ao clicar em um objeto selecionado no Windows Explorer.
Esse sinalizador não é combinado com SELFLAG_ADDSELECTION ou SELFLAG_TAKESELECTION.

Requisitos

Requisito Valor
parâmetro
Oleacc.h

Confira também

IAccessible::accSelect

Selecionando objetos filho