Menüelement (MSAA UI-Elementreferenz)
Hinweis
In diesem Thema werden Menüelementobjekte für Zwecke der MSAA-Ui-Elementreferenz beschrieben. Das Erstellen von Menüelementobjekten 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 Menüelement stellt ein bestimmtes Element in einer Menüleiste oder einem Popupmenü dar. Microsoft Active Accessibility erstellt beispielsweise ein Menüelementobjekt für das Menü Datei in der Menüleiste. Auf ähnliche Weise erstellt Microsoft Active Accessibility ein Menüelementobjekt für das Menüelement Öffnen aus dem Einblehmenü Datei .
Der Fensterklassenname für ein Menüelement lautet "#32768".
IAccessible-Methoden
Ein Menüelement unterstützt die folgenden IAccessible-Methoden :
| Methode | Kommentare |
|---|---|
| accDoDefaultAction | Bei Menüelementen über die Menüleiste zeigt accDoDefaultAction das Menü je nach Status des Menüs entweder an oder schließt es. Für Menüelemente aus einem Popupmenü klickt accDoDefaultAction auf das Menüelement, um den Menübefehl auszuführen. |
| acchittest | |
| accLocation | |
| accNavigate | |
| accSelect |
IAccessible-Eigenschaften
Ein Menüelement unterstützt die folgenden IAccessible-Eigenschaften :
| Eigenschaft | Kommentare |
|---|---|
| get_accChild | Ruft die IDispatch-Schnittstelle zum Popupmenüobjekt für dieses Element ab. |
| get_accChildCount | Die ChildCount-Eigenschaft ist eine für Menüelemente, die ein Menü oder Untermenü anzeigen. andernfalls ist die ChildCount-Eigenschaft 0. |
| get_accDefaultAction | Die DefaultAction-Eigenschaft für Menüelemente, die ein Menü oder Untermenü anzeigen, lautet je nach Status des Menüs entweder "Öffnen" oder "Schließen". Die DefaultAction-Eigenschaft für alle anderen Menüelemente ist "Execute". |
| get_accFocus | |
| get_accKeyboardShortcut | Die KeyboardShortcut-Eigenschaft ist die Zugriffstaste des Menüelements, d. h. das unterstrichene Zeichen im Text des Namens des Menüelements. Beispielsweise lautet die KeyboardShortcut-Eigenschaft für das MenüelementFile "f". |
| get_accName | Die Name-Eigenschaft ist mit dem Namen des Menüelements identisch. |
| get_accParent | Die Parent-Eigenschaft ist das Menüleisten- oder Popupmenü, das das Menüelement enthält. |
| get_accRole | Die Role-Eigenschaft ist ROLE_SYSTEM_MENUITEM. |
| get_accState | Die State-Eigenschaft ist entweder STATE_SYSTEM_INVISIBLE oder eine Kombination aus mindestens einem der folgenden Werte: STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_CHECKED | STATE_SYSTEM_DEFAULT | STATE_SYSTEM_HOTTRACKED | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_HASPOPUP |
Hinweise
- Wenn accDoDefaultAction für ein Menüelement verwendet wird, gibt S_OK zurück, führt die Aktion jedoch nicht aus, wenn das in der Zugriffsschlüssel verwendete Zeichen ?, !, @oder ein anderes Zeichen ist, das die UMSCHALTTASTE oder eine andere Modifizierertaste erfordert. Dies geschieht auch auf internationalen Tastaturen mit einem Zugriffstastenzeichen, für das die ALT GR-Taste gedrückt werden muss.
- Die accSelect-Methode mit SELFLAG_TAKEFOCUS bewirkt nicht, dass ein Menüelement ein Popupmenü öffnet oder schließt. Clients verwenden die accDoDefaultAction-Methode , um ein Popupmenü zu öffnen oder zu schließen.
- Ein Menüleistenelement, das kein Popupmenü anzeigt, gibt "Application" für die Name-Eigenschaft anstelle des Namens des Menüelements zurück.