Symbolleistensteuerelement (MSAA UI-Elementreferenz)
Anmerkung
In diesem Thema werden Symbolleistensteuerelement Objekte für MSAA-UI-Elementreferenz beschrieben. Das Erstellen Symbolleistensteuerelements Objekte 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 Symbolleistensteuerelement enthält Schaltflächen, die Menübefehle ausführen und in der Regel in einem Fenster unterhalb der Menüleiste enthalten sind.
Der Name der Fensterklasse 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 accDoDefaultAction aufruft PostMessage mit der BM_CLICK Nachricht, um auf die angegebene Schaltfläche zu klicken. |
| accHitTest- | |
| accLocation- | |
| accNavigate- | |
| accSelect- |
IAccessible-Eigenschaften
Ein Symbolleistensteuerelement unterstützt die folgenden IAccessible Eigenschaften:
| Eigentum | 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 Schaltflächenstil der Symbolleiste ab. Schaltflächen mit der Formatvorlage TBSTYLE_DROPDOWN haben "Öffnen" als DefaultAction-Eigenschaft. Die DefaultAction-Eigenschaft für alle anderen Symbolleistenschaltflächen lautet "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 kaufmännisches Und-Zeichen (&) enthält, gibt Microsoft Active Accessibility eine Zeichenfolge ungleich Null als die KeyboardShortcut-eigenschaft zurück. |
| get_accName | Die eigenschaft Name für die Symbolleiste wird aus dem Fenstertext (oder der Beschriftung) des Steuerelements abgerufen. Dieser Text wird nicht mit der Symbolleiste angezeigt, daher müssen Serverentwickler aussagekräftigen Text in der Ressourcendefinitionsanweisung des Steuerelements bereitstellen, damit Benutzer von Clienthilfsprogrammen das Steuerelement identifizieren können. Der Fenstertext kann mithilfe der SetWindowText--Funktion festgelegt werden. |
| get_accParent | Die Übergeordnete-Eigenschaft ist ein Fenster ( ROLE_SYSTEM_WINDOW ), das das Steuerelement umgibt und denselben Name Eigenschaften- und Fensterklassennamen wie das Steuerelement aufweist. |
| get_accRole | Die eigenschaft Role ist ROLE_SYSTEM_TOOLBAR. |
| get_accSelection | |
| get_accState | Der Wert für die State-Eigenschaft für die Symbolleiste selbst ist Null, was bedeutet, dass das Objekt sichtbar ist. Mögliche Werte für die eigenschaft State 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.