SELFLAG-Konstanten

In diesem Thema werden die konstanten Werte beschrieben, die verwendet werden, um anzugeben, wie ein barrierefreies Objekt ausgewählt wird oder den Fokus übernimmt. Die Konstanten werden in oleacc.h definiert und mit der IAccessible::accSelect-Methode verwendet.

Die folgenden Kombinationen sind nicht zulässig:

  • SELFLAG _ ADDSELECTION | SELFLAG _ REMOVESELECTION
  • SELFLAG _ ADDSELECTION | SELFLAG _ TAKESELECTION
  • SELFLAG _ REMOVESELECTION | SELFLAG _ TAKESELECTION
  • SELFLAG _ EXTENDSELECTION | SELFLAG _ TAKESELECTION

Hinweis für Clients: Microsoft Active Accessibility unterstützt die Auswahl des Texts in Bearbeitungs- und Rich Edit-Steuerelementen nicht, da der Text als Zeichenfolge in der Value-Eigenschaft des Objekts verfügbar gemacht wird.

Informationen zum Ausführen komplexer Auswahlvorgänge finden Sie unter Auswählen von untergeordneten Objekten.

Konstante/Wert Beschreibung
SELFLAG_NONE
0
Führt keine Aktion aus. Microsoft Active Accessibility ändert die Auswahl oder den Fokus nicht.
SELFLAG_TAKEFOCUS
0x1
Legt den Fokus auf das -Objekt fest und macht es zum Auswahlanker. Dieses Flag wird von sich aus verwendet und ändert die Auswahl nicht. Der Effekt ähnelt dem manuellen Verschieben des Fokus durch Drücken einer PFEILTASTE, während sie die STRG-TASTE im Windows Explorer oder in einem beliebigen Mehrfachauswahllistenfeld gedrückt hält.
Bei -Objekten, die über STATE_SYSTEM_MULTISELECTABLEverfügen, SELFLAG_TAKEFOCUS mit den folgenden Werten kombiniert:
  • SELFLAG_TAKESELECTION
  • SELFLAG_EXTENDSELECTION
  • SELFLAG_ADDSELECTION
  • SELFLAG_REMOVESELECTION
  • SELFLAG_ADDSELECTION
SELFLAG_EXTENDSELECTION
  • SELFLAG_REMOVESELECTION
  • SELFLAG_EXTENDSELECTIONWenn Sie IAccessible::accSelect mit dem SELFLAG_TAKEFOCUS-Flag für ein Objekt aufrufen, das über ein HWNDverfügt, wird das Flag nur wirksam, wenn das übergeordnete Element des Objekts bereits den Fokus besitzt.
    SELFLAG_TAKESELECTION
    0x2
    Wählt das -Objekt aus und entfernt die Auswahl aus allen anderen Objekten im Container.
    Sofern es nicht mit einem SELFLAG_TAKEFOCUS wird, ändert dieses Flag den Fokus oder den Auswahlanker nicht. Die SELFLAG_TAKESELECTION
    SELFLAG_TAKEFOCUS Kombination entspricht dem Einfachklicken auf ein Element im Windows Explorer.
    Dieses Flag darf nicht mit den folgenden Flags kombiniert werden:
    • SELFLAG_ADDSELECTION
    • SELFLAG_REMOVESELECTION
    • SELFLAG_EXTENDSELECTION
    SELFLAG_EXTENDSELECTION
    0x4
    Ändert die Auswahl, sodass alle Objekte zwischen dem Auswahlanker und diesem Objekt den Auswahlzustand des Ankerobjekts übernehmen. Wenn das Ankerobjekt nicht ausgewählt ist, werden die Objekte aus der Auswahl entfernt. Wenn das Ankerobjekt ausgewählt ist, wird die Auswahl erweitert, um dieses -Objekt und alle Dazwischen-Objekte ein- und ein- zu schließen. Legen Sie den Auswahlzustand fest, indem Sie dieses Flag mit SELFLAG_ADDSELECTION oder SELFLAG_REMOVESELECTION.
    Sofern es nicht mit einem SELFLAG_TAKEFOCUS wird, ändert dieses Flag den Fokus oder den Auswahlanker nicht. Die SELFLAG_EXTENDSELECTION
    SELFLAG_TAKEFOCUS Kombination entspricht dem manuellen Hinzufügen eines Elements zu einer Auswahl durch Halten der UMSCHALTTASTE und Klicken auf ein nicht ausgewähltes Objekt im Windows Explorer.
    Dieses Flag wird nicht mit der SELFLAG_TAKESELECTION.
    SELFLAG_ADDSELECTION
    0x8
    Fügt der aktuellen Auswahl das -Objekt hinzu. Mögliches Ergebnis ist eine nicht zusammenhängende Auswahl.
    Sofern es nicht mit einem SELFLAG_TAKEFOCUS wird, ändert dieses Flag den Fokus oder den Auswahlanker nicht. Die SELFLAG_ADDSELECTION
    SELFLAG_TAKEFOCUS Kombination entspricht dem manuellen Hinzufügen eines Elements zu einer Auswahl durch Halten der STRG-TASTE und Klicken auf ein nicht ausgewähltes Objekt im Windows Explorer.
    Dieses Flag wird nicht mit einem SELFLAG_REMOVESELECTION oder SELFLAG_TAKESELECTION.
    SELFLAG_REMOVESELECTION
    0x10
    Entfernt das -Objekt aus der aktuellen Auswahl. Mögliches Ergebnis ist eine nicht zusammenhängende Auswahl.
    Sofern es nicht mit einem SELFLAG_TAKEFOCUS wird, ändert dieses Flag den Fokus oder den Auswahlanker nicht. Die SELFLAG_REMOVESELECTION
    SELFLAG_TAKEFOCUS Kombination entspricht dem manuellen Entfernen eines Elements aus einer Auswahl, indem die STRG-Taste gedrückt wird, während im Explorer auf ein ausgewähltes Objekt Windows wird.
    Dieses Flag wird nicht mit einem SELFLAG_ADDSELECTION oder SELFLAG_TAKESELECTION.

    Anforderungen

    Anforderung Wert
    Header
    Oleacc.h

    Weitere Informationen

    IAccessible::accSelect

    Auswählen von untergeordneten Objekten