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.