Constantes SELFLAG

Cette rubrique décrit les valeurs constantes utilisées pour spécifier la façon dont un objet accessible devient sélectionné ou prend le focus. Les constantes sont définies dans oleacc.h et sont utilisées avec la méthode IAccessible::accSelect .

Les combinaisons suivantes ne sont pas autorisées :

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

Remarque pour les clients : Microsoft Active Accessibility ne prend pas en charge la sélection du texte contenu dans les contrôles d’édition et d’édition enrichie, car le texte est exposé sous forme de chaîne dans la propriété Value de l’objet.

Pour plus d’informations sur la façon d’effectuer des opérations de sélection complexes, consultez Sélection d’objets enfants.

Constante/valeur Description
SELFLAG_NONE
0
N’effectue aucune action. Microsoft Active Accessibility ne modifie pas la sélection ou le focus.
SELFLAG_TAKEFOCUS
0x1
Définit le focus sur l’objet et en fait l’ancre de sélection. Utilisé par lui-même, cet indicateur ne modifie pas la sélection. L’effet est similaire au déplacement manuel du focus en appuyant sur une touche de direction tout en maintenant la touche CTRL enfoncée dans Windows Explorer ou dans toute zone de liste à sélection multiple.
Avec les objets qui ont le STATE_SYSTEM_MULTISELECTABLE, SELFLAG_TAKEFOCUS est combiné avec les valeurs suivantes :
  • SELFLAG_TAKESELECTION
  • SELFLAG_EXTENDSELECTION
  • SELFLAG_ADDSELECTION
  • SELFLAG_REMOVESELECTION
  • SELFLAG_ADDSELECTION
  • SELFLAG_EXTENDSELECTION
  • SELFLAG_REMOVESELECTION
  • SELFLAG_EXTENDSELECTION
Si vous appelez IAccessible::accSelect avec l’indicateur SELFLAG_TAKEFOCUS sur un objet qui a un HWND, l’indicateur prend effet uniquement si le parent de l’objet a déjà le focus.
SELFLAG_TAKESELECTION
0x2
Sélectionne l’objet et supprime la sélection de tous les autres objets du conteneur.
Sauf s’il est combiné avec SELFLAG_TAKEFOCUS, cet indicateur ne modifie pas le focus ou l’ancre de sélection. La combinaison SELFLAG_TAKESELECTION/SELFLAG_TAKEFOCUS équivaut à cliquer un seul clic sur un élément dans Windows Explorer.
Cet indicateur ne doit pas être combiné avec les indicateurs suivants :
  • SELFLAG_ADDSELECTION
  • SELFLAG_REMOVESELECTION
  • SELFLAG_EXTENDSELECTION
SELFLAG_EXTENDSELECTION
0x4
Modifie la sélection afin que tous les objets entre l’ancre de sélection et cet objet prennent l’état de sélection de l’objet d’ancrage. Si l'objet d'ancrage n'est pas sélectionné, les objets sont enlevés de la sélection. Si l’objet d’ancrage est sélectionné, la sélection est étendue pour inclure cet objet et tous les objets intermédiaires. Définissez l’état de sélection en combinant cet indicateur avec SELFLAG_ADDSELECTION ou SELFLAG_REMOVESELECTION.
Sauf s’il est combiné avec SELFLAG_TAKEFOCUS, cet indicateur ne modifie pas le focus ou l’ancre de sélection. La combinaison SELFLAG_EXTENDSELECTION/SELFLAG_TAKEFOCUS équivaut à ajouter manuellement un élément à une sélection en maintenant la touche Maj enfoncée et en cliquant sur un objet non sélectionné dans Windows Explorer.
Cet indicateur n’est pas combiné avec SELFLAG_TAKESELECTION.
SELFLAG_ADDSELECTION
0x8
Ajoute l’objet à la sélection actuelle ; le résultat possible est une sélection non incohérente.
Sauf s’il est combiné avec SELFLAG_TAKEFOCUS, cet indicateur ne modifie pas le focus ou l’ancre de sélection. La combinaison SELFLAG_ADDSELECTION/SELFLAG_TAKEFOCUS équivaut à ajouter manuellement un élément à une sélection en maintenant la touche Ctrl enfoncée et en cliquant sur un objet non sélectionné dans Windows Explorer.
Cet indicateur n’est pas combiné avec SELFLAG_REMOVESELECTION ou SELFLAG_TAKESELECTION.
SELFLAG_REMOVESELECTION
0x10
Supprime l’objet de la sélection actuelle ; le résultat possible est une sélection non incohérente.
Sauf s’il est combiné avec SELFLAG_TAKEFOCUS, cet indicateur ne modifie pas le focus ou l’ancre de sélection. La combinaison SELFLAG_REMOVESELECTION/SELFLAG_TAKEFOCUS équivaut à supprimer manuellement un élément d’une sélection, en maintenant la touche CTRL enfoncée tout en cliquant sur un objet sélectionné dans Windows Explorer.
Cet indicateur n’est pas combiné avec SELFLAG_ADDSELECTION ou SELFLAG_TAKESELECTION.

Spécifications

Condition requise Valeur
En-tête
Oleacc.h

Voir aussi

IAccessible::accSelect

Sélection d’objets enfants