Freigeben über

Kombinationsfeld (MSAA UI-Elementreferenz)

  • Artikel

Hinweis

In diesem Thema werden Kombinationsfeldobjekte für die MSAA-Benutzeroberflächenelementreferenz beschrieben. Das Erstellen von Kombinationsfeldobjekten in verschiedenen Benutzeroberflächenframeworks wird hier nicht beschrieben. Weitere Informationen finden Sie in der API-Referenzdokumentation für das von Ihnen verwendete Benutzeroberflächenframework.

 

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 (eine Drucktaste) 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 Fensterklassenname 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 Steuerelement "Bearbeiten" oder "Statischer Text"
  • Der Dropdownpfeil (bei dem es sich um eine Schaltfläche handelt)
  • Das Listenfeld
  • Die Listenelemente im Listenfeld

IAccessible-Methoden

Kombinationsfelde unterstützen die folgenden IAccessible-Methoden :

IAccessible-Eigenschaften

Kombinationsfelde unterstützen die folgenden IAccessible-Eigenschaften :

  • get_accChild

  • 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", abhängig vom Status der Dropdownliste
    Listenfeld Keine
    Listenelement "Doppelklick"

     

  • get_accDescription

  • get_accFocus

  • get_accHelp

  • get_accHelpTopic

  • 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

     

    Die Zugriffsschlüssel für ein Kombinationsfeld ist das unterstrichene Zeichen im Text aus einem zugeordneten statischen Textsteuerelement, das das Kombinationsfeld beschriftt. In einem Standarddialogfeld öffnen, das Dateien öffnet, z. B. in Microsoft WordPad, weist das Kombinationsfeld "Dateien vom Typ:" die TastaturShortcut "Alt+t" auf.

  • 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", abhängig vom Status der Dropdownliste
    Listenfeld Zugeordnete Bezeichnung
    Listenelement Text des Listenelements

     

    Die Name-Eigenschaft eines Kombinationsfelds, dessen untergeordnetes Bearbeitungssteuerelement und sein untergeordnetes Listenfeld sind der Text aus einem zugeordneten statischen Textsteuerelement, das das Kombinationsfeld beschriftt. Beispielsweise sind in einem Standarddialogfeld Öffnen, das Dateien öffnet, z. B. in WordPad, die Nameneigenschaften für die beiden Kombinationsfelder "Look in:" und "Files of type:".

  • get_accParent: Die folgende Tabelle zeigt den übergeordneten Wert für verschiedene Teile eines Kombinationsfelds.

    Kombinationsfeldteil Parent
    Kombinationsfeldfenster Ein Fenster mit der Role-Eigenschaftvon ROLE_SYSTEM_WINDOW , das das Kombinationsfeld umgibt und denselben Name-Eigenschafts - und Fensterklassennamen wie das Kombinationsfeld aufweist.
    Steuerelement bearbeiten (oder statisches Textsteuerelement) Das Kombinationsfeldfenster.
    Dropdownpfeil Das Kombinationsfeldfenster.
    Übergeordnetes Listenfeldfenster Das Kombinationsfeldfenster. Dieses Fenster umgibt 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_SYSTEM_TEXT oder ROLE_SYSTEM_STATICTEXT
    Dropdownpfeil ROLE_SYSTEM_PUSHBUTTON
    Listenfeld ROLE_SYSTEM_LIST
    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 ist und nicht gedrückt wird; 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 es VT_EMPTY zurückgeben soll.

IAccessible-Schnittstelle