Symbolleistensteuerelement (MSAA UI Element Reference)

Hinweis

In diesem Thema werden Symbolleistensteuerelementobjekte für Zwecke der MSAA-UI-Elementreferenz beschrieben. Wie Sie Symbolleistensteuerelementobjekte in verschiedenen Benutzeroberflächenframeworks erstellen, wird hier nicht beschrieben. Weitere Informationen finden Sie in der API-Referenzdokumentation für das von Ihnen verwendete Benutzeroberflächenframework.

Ein Symbolleistensteuerelement enthält Schaltflächen, die Menübefehle ausführen und ist normalerweise in einem Fenster unter der Menüleiste enthalten.

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

IAccessible-Methoden

Ein Symbolleistensteuerelement 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 accDoDefaultActionPostMessage mit der BM_CLICK Nachricht auf, um auf die angegebene Schaltfläche zu klicken.
accHitTest
accLocation
accNavigate
accSelect

IAccessible-Eigenschaften

Ein Symbolleistensteuerelement unterstützt die folgenden IAccessible-Eigenschaften :

Eigenschaft	Kommentare
get_accChild
get_accChildCount	Die ChildCount-Eigenschaft ist die Anzahl der Steuerelemente, 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 Stil der Symbolleistenschaltfläche ab. Schaltflächen mit dem Stil TBSTYLE_DROPDOWN haben "Open" als DefaultAction-Eigenschaft . Die DefaultAction-Eigenschaft für alle anderen Symbolleistenschaltflächen ist "Drücken".
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 Zeichen amper und ()& enthält, gibt Microsoft Active Accessibility als KeyboardShortcut-Eigenschaft eine Nicht-Null-Zeichenfolge zurück.
get_accName	Die Name-Eigenschaft für die Symbolleiste wird aus dem Fenstertext des Steuerelements (oder Untertitel) abgerufen. Dieser Text wird nicht mit der Symbolleiste angezeigt, sodass Serverentwickler aussagekräftigen Text in der Ressourcendefinitionsanweisung des Steuerelements bereitstellen müssen, damit Benutzer von Clientprogrammen 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 umgibt und denselben Name-Eigenschafts - und Fensterklassennamen wie das Steuerelement aufweist.
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, 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

Hinweise

Die Schaltflächen auf einer Symbolleiste senden EVENT_OBJECT_STATECHANGE Ereignisse.

Zugehörige Themen

IAccessible-Schnittstelle