Kombinationsfeld (MSAA UI-Elementreferenz)
Hinweis
In diesem Thema werden Combo Box-Objekte für die MSAA UI-Elementreferenz beschrieben. Das Erstellen von Combo Box-Objekten in verschiedenen Benutzeroberflächenframeworks wird hier nicht beschrieben. Informationen zum verwendeten BENUTZERoberflächenframework finden Sie in der API-Referenzdokumentation.
Ein Kombinationsfeld ist ein Listenfeld, das mit einem statischen Steuerelement oder einem Bearbeitungssteuerelement kombiniert ist und das momentan ausgewählte Element im Listenfeldbereich des Kombinationsfelds anzeigt. Der Listenfeldteil des Steuerelements wird jederzeit oder nur in der Dropdownliste angezeigt, wenn der Benutzer den Dropdownpfeil (d. h. eine Pushschaltfläche) neben dem Steuerelement auswählt. Wenn das Auswahlfeld ein Bearbeitungssteuerelement ist, kann der Benutzer Informationen eingeben, die nicht in der Liste enthalten sind. Andernfalls kann der Benutzer nur Elemente in der Liste auswählen.
Der Name der Fensterklasse für ein Kombinationsfeld lautet "COMBOBOX".
Der Inhalt der IAccessible-Eigenschaften hängt davon ab, welcher der folgenden Teile des Kombinationsfelds vom Client abgefragt wird:
- Das Kombinationsfeldfenster
- Das Bearbeitungssteuerelement oder das statische Textsteuerelement
- Der Dropdownpfeil (eine Pushschaltfläche)
- Das Listenfeld
- Die Listenelemente im Listenfeld
IAccessible-Methoden
Kombinationsfelder unterstützen die folgenden IAccessible-Methoden:
IAccessible-Eigenschaften
Kombinationsfelder unterstützen die folgenden IAccessible-Eigenschaften:
get _ accChildCount: In der folgenden Tabelle wird der Wert der untergeordneten Anzahl für verschiedene Teile des Kombinationsfelds angezeigt.
Kombinationsfeldteil ChildCount Kombinationsfeldfenster 3 Bearbeitungssteuerelement 0 Dropdownpfeil 0 Listenfeld Die Anzahl der Listenelemente Listenelement 0 get _ accDefaultAction: Die folgende Tabelle zeigt die DefaultAction-Eigenschaft für verschiedene Teile eines Kombinationsfelds.
Kombinationsfeldteil Defaultaction Kombinationsfeldfenster Keine Bearbeitungssteuerelement Keine Dropdownpfeil "Öffnen" oder "Schließen" je nach Status der Dropdownliste Listenfeld Keine Listenelement "Doppelklicken" get _ accKeyboardShortcut: Die folgende Tabelle zeigt die KeyboardShortcut-Eigenschaft für verschiedene Teile eines Kombinationsfelds.
Kombinationsfeldteil KeyboardShortcut Kombinationsfeldfenster Zugriffsschlüssel der zugeordneten Bezeichnung Bearbeitungssteuerelement Keine Dropdownpfeil "ALT+NACH-UNTEN" Listenfeld Keine Listenelement Keine Der Zugriffsschlüssel für ein Kombinationsfeld ist das unterstrichene Zeichen im Text aus einem zugeordneten statischen Textsteuerelement, das das Kombinationsfeld bezeichnet. Beispielsweise enthält das Kombinationsfeld mit der Bezeichnung "Dateien vom Typ:" in einem Standarddialogfeld, in dem Dateien geöffnet werden, z. B. in Microsoft WordPad, das KeyboardShortcut "ALT+T".
get _ accName: Die folgende Tabelle zeigt die Name-Eigenschaft für verschiedene Teile eines Kombinationsfelds.
Kombinationsfeldteil Name Kombinationsfeldfenster Statisches Textsteuerelement, das als Bezeichnung verwendet wird Bearbeitungssteuerelement Statisches Textsteuerelement, das als Bezeichnung verwendet wird Dropdownpfeil "Öffnen" oder "Schließen" je nach Status der Dropdownliste Listenfeld Zugeordnete Bezeichnung Listenelement Text des Listenelements Die Name-Eigenschaft eines Kombinationsfelds, seines untergeordneten Bearbeitungssteuerelements und seines untergeordneten Listenfelds ist der Text aus einem zugeordneten statischen Textsteuerelement, das das Kombinationsfeld bezeichnet. In einem Standarddialogfeld Öffnen, in dem Dateien geöffnet werden, z. B. in WordPad, sind die Name-Eigenschaften für die beiden Kombinationsfelder "Look in:" und "Files of type:".
get _ accParent: In der folgenden Tabelle wird der übergeordnete Wert für verschiedene Teile eines Kombinationsfelds angezeigt.
Kombinationsfeldteil Parent Kombinationsfeldfenster Ein Fenster mit der Role-Eigenschaft von ROLE SYSTEM _ _ WINDOW, das das Kombinationsfeld umschließt und über die gleiche Name-Eigenschaft und den gleichen Fensterklassennamen wie das Kombinationsfeld verfügt. Steuerelement bearbeiten (oder statisches Textsteuerelement) Das Kombinationsfeldfenster. Dropdownpfeil Das Kombinationsfeldfenster. Übergeordnetes Fenster des Listenfelds Das Kombinationsfeldfenster. Dieses Fenster umschließt das Listenfeld. Listenfeld Das übergeordnete Listenfeldfenster. Listenelement Das Listenfeld. get _ accRole: Die folgende Tabelle zeigt die Role-Eigenschaft für verschiedene Teile eines Kombinationsfelds.
Kombinationsfeldteil Rolle Kombinationsfeldfenster ROLE _ SYSTEM _ COMBOBOX Steuerelement bearbeiten (oder statisches Textsteuerelement) ROLE (ROLLE) _ SYSTEM _ TEXT oder ROLE SYSTEM _ _ STATICTEXT Dropdownpfeil _ _ ROLLENSYSTEM-PUSHBUTTON Listenfeld _ _ ROLLENSYSTEMLISTE Listenelement ROLE _ SYSTEM _ LISTITEM get _ accState: Die folgende Tabelle zeigt die State-Eigenschaft für verschiedene Teile eines Kombinationsfelds.
Kombinationsfeldteil Mögliche Zustände Kombinationsfeldfenster STATE _ SYSTEM _ INVISIBLE | STATE SYSTEM _ _ UNAVAILABLE | STATE SYSTEM _ _ FOCUSED | STATE SYSTEM _ _ FOCUSABLE | STATE SYSTEM _ _ NORMAL | STATE SYSTEM _ _ EXPANDED | STATE SYSTEM _ _ COLLAPSED Bearbeitungssteuerelement STATE _ SYSTEM _ INVISIBLE | STATE SYSTEM _ _ UNAVAILABLE | STATE SYSTEM _ _ FOCUSED | STATE SYSTEM _ _ FOCUSABLE | STATE SYSTEM _ _ NORMAL Dropdownpfeil 0, was bedeutet, dass die Schaltfläche sichtbar und nicht gedrückt ist. oder STATE _ SYSTEM _ PRESSED | STATE SYSTEM _ _ INVISIBLE | STATE SYSTEM _ _ NORMAL Listenfeld STATE _ SYSTEM _ INVISIBLE | STATE SYSTEM _ _ UNAVAILABLE | STATE SYSTEM _ _ FOCUSED | STATE SYSTEM _ _ FOCUSABLE | STATE SYSTEM _ _ FLOATING | STATE _ SYSTEM _ NORMAL Listenelement STATE _ SYSTEM _ INVISIBLE | STATE SYSTEM _ _ FOCUSABLE | STATE SYSTEM _ _ FOCUSED | STATE SYSTEM _ _ SELECTABLE | STATE SYSTEM _ _ SELECTED | STATE _ SYSTEM _ NORMAL get _ accValue: Die folgende Tabelle zeigt die Value-Eigenschaft für verschiedene Teile eines Kombinationsfelds.
Kombinationsfeldteil Wert Kombinationsfeldfenster Text des aktuell ausgewählten Listenelements Bearbeitungssteuerelement Text des aktuell ausgewählten Listenelements Dropdownpfeil Keine Listenfeld Keine Listenelement Keine
Notizen
- Wenn accNavigate mit dem NAVDIR _ NEXT-Flag im Listenfeldteil eines Kombinationsfelds aufgerufen wird, navigiert es fälschlicherweise zum Taskleistenfenster, wenn VT _ EMPTY zurückgegeben werden soll.