SELFLAG-Konstanten

  • Artikel

In diesem Thema werden die konstanten Werte beschrieben, mit denen angegeben wird, wie ein barrierefreies Objekt ausgewählt wird oder den Fokus erhält. 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 nicht die Auswahl des Texts, der in Bearbeitungs- und Rich-Bearbeitungssteuerelementen enthalten ist, 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 untergeordneter Objekte.

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 selbst verwendet und ändert die Auswahl nicht. Der Effekt ähnelt dem manuellen Verschieben des Fokus durch Drücken einer PFEILTASTE, während die STRG-TASTE in Windows Explorer oder in einem beliebigen Mehrfachauswahllistenfeld gedrückt gehalten wird.
Bei Objekten mit dem STATE_SYSTEM_MULTISELECTABLE wird SELFLAG_TAKEFOCUS mit den folgenden Werten kombiniert:
  • SELFLAG_TAKESELECTION
  • SELFLAG_EXTENDSELECTION
  • SELFLAG_ADDSELECTION
  • SELFLAG_REMOVESELECTION
  • SELFLAG_ADDSELECTION
  • SELFLAG_EXTENDSELECTION
  • SELFLAG_REMOVESELECTION
  • SELFLAG_EXTENDSELECTION
Wenn Sie IAccessible::accSelect mit dem SELFLAG_TAKEFOCUS-Flag für ein Objekt aufrufen, das über einen HWND verfügt, wird das Flag nur wirksam, wenn das übergeordnete Objekt bereits den Fokus hat.
SELFLAG_TAKESELECTION
0x2
 Wählt das -Objekt aus und entfernt die Auswahl aus allen anderen Objekten im Container.
Sofern es nicht mit SELFLAG_TAKEFOCUS kombiniert wird, ändert dieses Flag weder den Fokus noch den Auswahlanker. Die Kombination SELFLAG_TAKESELECTION/SELFLAG_TAKEFOCUS entspricht dem Einmaligen Klicken auf ein Element in 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 objekte dazwischen einzuschließen. Legen Sie den Auswahlstatus fest, indem Sie dieses Flag mit SELFLAG_ADDSELECTION oder SELFLAG_REMOVESELECTION kombinieren.
Sofern es nicht mit SELFLAG_TAKEFOCUS kombiniert wird, ändert dieses Flag weder den Fokus noch den Auswahlanker. Die Kombination SELFLAG_EXTENDSELECTION/SELFLAG_TAKEFOCUS entspricht dem manuellen Hinzufügen eines Elements zu einer Auswahl, indem Sie die UMSCHALTTASTE gedrückt halten und in Windows Explorer auf ein nicht ausgewähltes Objekt klicken.
Dieses Flag wird nicht mit SELFLAG_TAKESELECTION kombiniert.
SELFLAG_ADDSELECTION
0x8
 Fügt das -Objekt der aktuellen Auswahl hinzu. mögliches Ergebnis ist eine nicht zusammenhängende Auswahl.
Sofern es nicht mit SELFLAG_TAKEFOCUS kombiniert wird, ändert dieses Flag weder den Fokus noch den Auswahlanker. Die Kombination SELFLAG_ADDSELECTION/SELFLAG_TAKEFOCUS entspricht dem manuellen Hinzufügen eines Elements zu einer Auswahl, indem Sie die STRG-TASTE gedrückt halten und in Windows Explorer auf ein nicht ausgewähltes Objekt klicken.
Dieses Flag wird nicht mit SELFLAG_REMOVESELECTION oder SELFLAG_TAKESELECTION kombiniert.
SELFLAG_REMOVESELECTION
0x10
 Entfernt das -Objekt aus der aktuellen Auswahl. mögliches Ergebnis ist eine nicht zusammenhängende Auswahl.
Sofern es nicht mit SELFLAG_TAKEFOCUS kombiniert wird, ändert dieses Flag weder den Fokus noch den Auswahlanker. Die Kombination SELFLAG_REMOVESELECTION/SELFLAG_TAKEFOCUS entspricht dem manuellen Entfernen eines Elements aus einer Auswahl, indem Sie die STRG-TASTE gedrückt halten, während Sie in Windows Explorer auf ein ausgewähltes Objekt klicken.
Dieses Flag wird nicht mit SELFLAG_ADDSELECTION oder SELFLAG_TAKESELECTION kombiniert.

Anforderungen

Anforderung Wert
Header
Oleacc.h

Siehe auch

IAccessible::accSelect

Auswählen untergeordneter Objekte