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.