Symbolleisten-Steuerelement (REFERENZ ZUM MSAA-UI-Element)

Hinweis

In diesem Thema werden Symbolleisten-Steuerelementobjekte für die MSAA-Benutzeroberflächenelementreferenz beschrieben. Das Erstellen von Symbolleisten-Steuerelementobjekten in verschiedenen Benutzeroberflächenframeworks wird hier nicht beschrieben. Weitere Informationen finden Sie in der API-Referenzdokumentation für das benutzeroberflächenframework, das Sie verwenden.

Ein Symbolleisten-Steuerelement enthält Schaltflächen, die Menübefehle ausführen und in der Regel in einem Fenster unterhalb der Menüleiste enthalten sind.

Der Fensterklassenname für ein Symbolleisten-Steuerelement ist TOOLBARCLASSNAME, der in Commctrl.h als "ToolbarWindow32" definiert ist.

IAccessible-Methoden

Ein Symbolleisten-Steuerelement unterstützt die folgenden IAccessible-Methoden:

Methode Kommentare
accDoDefaultAction Die Symbolleiste selbst unterstützt die accDoDefaultAction-Methode. Für die Schaltflächen auf der Symbolleiste ruft accDoDefaultAction PostMessage mit der BM _ CLICK-Nachricht auf, um auf die angegebene Schaltfläche zu klicken.
accHitTest
accLocation
accNavigate
accSelect

IAccessible-Eigenschaften

Ein Symbolleisten-Steuerelement unterstützt die folgenden IAccessible-Eigenschaften:

Eigenschaft Kommentare
get _ accChild
get _ accChildCount Die ChildCount-Eigenschaft ist die Anzahl von Steuerelementen, die in der Symbolleiste enthalten sind.
get _ accDefaultAction Das Symbolleistenobjekt selbst verfügt nicht über eine DefaultAction-Eigenschaft. Die DefaultAction-Eigenschaft für Symbolleistenschaltflächen hängt vom Symbolleisten-Schaltflächenstil ab. Schaltflächen mit dem Stil TBSTYLE _ DROPDOWN haben "Open" als DefaultAction-Eigenschaft. Die DefaultAction-Eigenschaft für alle anderen Symbolleistenschaltflächen ist "Press".
get _ accDescription
get _ accFocus
get _ accHelp
get _ accHelpTopic
get _ accKeyboardShortcut Symbolleisten verfügen nicht über Tastenkombinationen. Wenn der Fenstertext für die Symbolleiste jedoch ein ampersand-Zeichen (&) enthält, gibt Microsoft Active Accessibility eine Zeichenfolge zurück, die nicht NULL ist, als KeyboardShortcut-Eigenschaft.
get _ accName Die Name-Eigenschaft für die Symbolleiste wird aus dem Fenstertext (oder der Beschriftung) des Steuerelements ermittelt. Dieser Text wird nicht in der Symbolleiste angezeigt. Serverentwickler müssen daher aussagekräftigen Text in der Ressourcendefinitions-Anweisung des Steuerelements bereitstellen, damit Benutzer von Client-Hilfsprogrammen das Steuerelement identifizieren können. Der Fenstertext kann mithilfe der SetWindowText-Funktion festgelegt werden.
get _ accParent Die Parent-Eigenschaft ist ein Fenster ( ROLE SYSTEM _ _ WINDOW ), das das Steuerelement umschließt und über die gleiche Name-Eigenschaft und den gleichen Fensterklassennamen wie das -Steuerelement verfügt.
get _ accRole Die Role-Eigenschaft ist ROLE SYSTEM _ _ TOOLBAR.
get _ accSelection
get _ accState Der Wert für die State-Eigenschaft für die Symbolleiste selbst ist 0 (null), was bedeutet, dass das Objekt sichtbar ist. Mögliche Werte für die State-Eigenschaft der Symbolleistenschaltflächen sind: STATE SYSTEM _ _ INVISIBLE oder
STATE _ SYSTEM _ UNAVAILABLE | STATE SYSTEM _ _ INVISIBLE | STATE SYSTEM _ _ MOVEABLE | STATE SYSTEM _ _ FOCUSED | STATE SYSTEM _ _ FOCUSABLE

Notizen

Die Schaltflächen auf einer Symbolleiste senden EVENT _ OBJECT _ STATECHANGE-Ereignisse.

IAccessible-Schnittstelle