Constantes SELFLAG

  • Artículo

En este tema se describen los valores constantes usados para especificar cómo se selecciona un objeto accesible o toma el foco. Las constantes se definen en oleacc.h y se usan con el método IAccessible::accSelect .

No se permiten las siguientes combinaciones:

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

Nota para los clientes: La accesibilidad activa de Microsoft no admite la selección del texto contenido en los controles de edición y edición enriquecida porque el texto se expone como una cadena en la propiedad Value del objeto.

Para obtener información sobre cómo realizar operaciones de selección complejas, vea Seleccionar objetos secundarios.

Constante o valor Descripción
SELFLAG_NONE
0
 No realiza ninguna acción. La accesibilidad activa de Microsoft no cambia la selección ni el foco.
SELFLAG_TAKEFOCUS
0x1
 Establece el foco en el objeto y lo convierte en el delimitador de selección. Usado por sí mismo, esta marca no modifica la selección. El efecto es similar a mover el foco manualmente presionando una tecla FLECHA mientras mantiene presionada la tecla CTRL en el Explorador de Windows o en cualquier cuadro de lista de selección múltiple.
Con los objetos que tienen el STATE_SYSTEM_MULTISELECTABLE, SELFLAG_TAKEFOCUS se combina con los siguientes valores:
  • SELFLAG_TAKESELECTION
  • SELFLAG_EXTENDSELECTION
  • SELFLAG_ADDSELECTION
  • SELFLAG_REMOVESELECTION
  • SELFLAG_ADDSELECTION
  • SELFLAG_EXTENDSELECTION
  • SELFLAG_REMOVESELECTION
  • SELFLAG_EXTENDSELECTION
Si llamas a IAccessible::accSelect con la marca SELFLAG_TAKEFOCUS en un objeto que tiene un HWND, la marca surtirá efecto solo si el elemento primario del objeto ya tiene el foco.
SELFLAG_TAKESELECTION
0x2
 Selecciona el objeto y quita la selección de todos los demás objetos del contenedor.
A menos que se combine con SELFLAG_TAKEFOCUS, esta marca no cambia el foco ni el delimitador de selección. La combinación SELFLAG_TAKESELECTION/SELFLAG_TAKEFOCUS equivale a hacer clic con un solo clic en un elemento en el Explorador de Windows.
Esta marca no se debe combinar con las marcas siguientes:
  • SELFLAG_ADDSELECTION
  • SELFLAG_REMOVESELECTION
  • SELFLAG_EXTENDSELECTION
SELFLAG_EXTENDSELECTION
0x4
 Modifica la selección para que todos los objetos entre el delimitador de selección y este objeto tomen el estado de selección del objeto de anclaje. Si el objeto delimitador no está seleccionado, los objetos se quitan de la selección. Si se selecciona el objeto de anclaje, la selección se extiende para incluir este objeto y todos los objetos entre ellos. Establezca el estado de selección combinando esta marca con SELFLAG_ADDSELECTION o SELFLAG_REMOVESELECTION.
A menos que se combine con SELFLAG_TAKEFOCUS, esta marca no cambia el foco ni el delimitador de selección. La combinación SELFLAG_EXTENDSELECTION/SELFLAG_TAKEFOCUS equivale a agregar manualmente un elemento a una selección manteniendo presionada la tecla MAYÚS y haciendo clic en un objeto no seleccionado en el Explorador de Windows.
Esta marca no se combina con SELFLAG_TAKESELECTION.
SELFLAG_ADDSELECTION
0x8
 Agrega el objeto a la selección actual; el resultado posible es una selección no contigua.
A menos que se combine con SELFLAG_TAKEFOCUS, esta marca no cambia el foco ni el delimitador de selección. La combinación de SELFLAG_ADDSELECTION/SELFLAG_TAKEFOCUS equivale a agregar manualmente un elemento a una selección manteniendo presionada la tecla CTRL y haciendo clic en un objeto no seleccionado en el Explorador de Windows.
Esta marca no se combina con SELFLAG_REMOVESELECTION o SELFLAG_TAKESELECTION.
SELFLAG_REMOVESELECTION
0x10
 Quita el objeto de la selección actual; el resultado posible es una selección no contigua.
A menos que se combine con SELFLAG_TAKEFOCUS, esta marca no cambia el foco ni el delimitador de selección. La combinación SELFLAG_REMOVESELECTION/SELFLAG_TAKEFOCUS equivale a quitar manualmente un elemento de una selección manteniendo presionada la tecla CTRL mientras hace clic en un objeto seleccionado en el Explorador de Windows.
Esta marca no se combina con SELFLAG_ADDSELECTION o SELFLAG_TAKESELECTION.

Requisitos

Requisito Value
Encabezado
Oleacc.h

Consulte también

IAccessible::accSelect

Selección de objetos secundarios