Menu, typ kontrolki
Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika firmy Microsoft dla Menu typu kontrolki.
Kontrolka menu umożliwia hierarchialną organizację elementów skojarzonych z poleceniami i procedurami obsługi zdarzeń. W typowej aplikacji systemu Microsoft Windows pasek menu zawiera kilka przycisków menu (takich jak Plik, Edytuji okno ), a każdy przycisk menu wyświetla menu. Menu zawiera kolekcję elementów menu (takich jak Nowy, Otwórzi Zamknij), które można rozwinąć, aby wyświetlić dodatkowe elementy menu lub wykonać określoną akcję po kliknięciu.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla Menu typu kontrolki. Wymagania automatyzacji interfejsu użytkownika mają zastosowanie do wszystkich kontrolek menu, w których platforma/platforma interfejsu użytkownika integruje obsługę automatyzacji interfejsu użytkownika dla typów kontrolek i wzorców kontrolek.
Ten temat zawiera następujące sekcje.
- typowa struktura drzewa
- odpowiednie właściwości
- wymagane wzorce kontrolek
- wymagane zdarzenia
- Tematy pokrewne
Typowa struktura drzewa
W poniższej tabeli przedstawiono typowy widok kontrolki i zawartości drzewa automatyzacji interfejsu użytkownika, który odnosi się do kontrolek menu i opisuje, co można zawierać w każdym widoku. Aby uzyskać więcej informacji na temat drzewa automatyzacji interfejsu użytkownika, zobacz Omówienie drzewa automatyzacji interfejsu użytkownika.
| Widok kontrolki | Widok zawartości |
|---|---|
|
|
Kontrolki menu są zawsze wyświetlane w widoku kontrolki i widoku zawartości drzewa automatyzacji interfejsu użytkownika. Kontrolki menu powinny być wyświetlane pod kontrolką, do których odwołują się informacje. Klienci automatyzacji interfejsu użytkownika mogą nasłuchiwać UIA_MenuOpenedEventId, aby zapewnić spójne uzyskiwanie informacji przekazywanych przez kontrolki menu. Kontrolki menu kontekstowego są specjalnym przypadkiem. Mogą one być wyświetlane jako elementy podrzędne pulpitu lub okna aplikacji najwyższego poziomu.
Kontrolka menu może zawierać inne kontrolki, takie jak kontrolki edycji i pola kombi, w jego strukturze. Te dodatkowe kontrolki odpowiadają "innym kontrolkom" wymienionym w poprzedniej tabeli w widokach kontrolki i zawartości.
Odpowiednie właściwości
W poniższej tabeli wymieniono właściwości automatyzacji interfejsu użytkownika, których wartość lub definicja jest szczególnie istotne dla Menu typ kontrolki. Aby uzyskać więcej informacji na temat właściwości automatyzacji interfejsu użytkownika, zobacz Pobieranie właściwości z elementów automatyzacji interfejsu użytkownika.
| Właściwość automatyzacji interfejsu użytkownika | Wartość | Notatki |
|---|---|---|
| UIA_ControlTypePropertyId | menu | |
| UIA_IsContentElementPropertyId | PRAWDZIWY | Kontrolka menu jest zawsze uwzględniana w widoku zawartości drzewa automatyzacji interfejsu użytkownika. |
| UIA_IsControlElementPropertyId | PRAWDZIWY | Kontrolka menu jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacji interfejsu użytkownika. |
| UIA_LabeledByPropertyId | ZERO | Nie przewiduje się żadnej etykiety z typową kontrolką menu. |
| UIA_NamePropertyId | Zobacz uwagi. | Kontrolka menu nie wymaga ustawienia właściwości Name lub może mieć taką samą nazwę jak skojarzona kontrolka, na przykład element menu, który otworzył podmenu. |
Wymagane wzorce kontrolek
Nie ma wymaganych wzorców kontrolek dla typu kontrolki Menu.
Zdarzenia wymagane
Kontrolki menu muszą zgłaszać zdarzenie UIA_MenuOpenedEventId po wyświetleniu na ekranie. Zdarzenie UIA_MenuOpenedEventId będzie zawierać tekst kontrolki. Zdarzenie UIA_MenuClosedEventId musi zostać podniesione, gdy menu zniknie z ekranu.
W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika, które są wymagane do obsługi kontrolek menu. Aby uzyskać więcej informacji na temat zdarzeń, zobacz Omówienie zdarzeń automatyzacji interfejsu użytkownika.
| Zdarzenie automatyzacji interfejsu użytkownika | Notatki |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId zdarzenie zmienione właściwości. | |
| UIA_IsEnabledPropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje właściwość IsEnabled, musi obsługiwać to zdarzenie. |
| UIA_IsOffscreenPropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje właściwość IsOffscreen, musi obsługiwać to zdarzenie. |
| UIA_MenuClosedEventId | |
| UIA_MenuOpenedEventId | |
| UIA_StructureChangedEventId |
Tematy pokrewne