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