Obsługa automatyzacji interfejsu użytkownika dla kontrolek typu menu
Uwaga
Ta dokumentacja jest przeznaczona dla deweloperów programu .NET Framework, którzy chcą używać zarządzanych klas automatyzacja interfejsu użytkownika zdefiniowanych w System.Windows.Automation przestrzeni nazw. Aby uzyskać najnowsze informacje na temat automatyzacja interfejsu użytkownika, zobacz Interfejs API usługi Windows Automation: automatyzacja interfejsu użytkownika.
Ten temat zawiera informacje o obsłudze automatyzacja interfejsu użytkownika firmy Microsoft dla typu kontrolki Menu. Opisuje on strukturę drzewa microsoft automatyzacja interfejsu użytkownika kontrolki oraz zawiera właściwości i wzorce sterowania dla określonych scenariuszy kontroli.
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, Edycja i Okno), a każdy przycisk menu wyświetla menu. Menu zawiera kolekcję elementów menu (takich jak Nowy, Otwórz i 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 automatyzacja interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki Menu. Wymagania dotyczące automatyzacja interfejsu użytkownika mają zastosowanie do wszystkich kontrolek listy, niezależnie od tego, czy windows Presentation Foundation (WPF), Win32 lub Windows Forms.
Wymagana struktura drzewa automatyzacja interfejsu użytkownika
W poniższej tabeli przedstawiono widok kontrolki i widok zawartości drzewa automatyzacja interfejsu użytkownika odnoszącego się do kontrolek menu i opisano, co można zawierać w każdym widoku. Aby uzyskać więcej informacji na temat drzewa automatyzacja interfejsu użytkownika, zobacz omówienie drzewa automatyzacja interfejsu użytkownika.
| Widok kontrolki | Widok zawartości |
|---|---|
| Menu - MenuItem (1 lub wiele) |
Nie dotyczy (chyba że kontrolka menu jest menu kontekstowym, które jest elementem nadrzędnym obiektu, który nie jest elementem menu) - MenuItem (1 lub wiele) |
Kontrolki menu są zawsze wyświetlane w widoku kontrolki i widoku zawartości drzewa automatyzacja interfejsu użytkownika. Typy kontrolek menu powinny być wyświetlane pod kontrolą, do których odwołują się informacje. automatyzacja interfejsu użytkownika klienci muszą nasłuchiwaćMenuOpenedEvent, aby zapewnić spójne uzyskiwanie informacji przekazywanych przez kontrolki menu. Kontrolki menu kontekstowego są specjalnym przypadkiem. Są one wyświetlane jako elementy podrzędne pulpitu.
Wymagane właściwości automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono właściwości automatyzacja interfejsu użytkownika, których wartość lub definicja jest szczególnie istotna dla typu kontrolki Menu. Aby uzyskać więcej informacji na temat właściwości automatyzacja interfejsu użytkownika, zobacz automatyzacja interfejsu użytkownika Właściwości dla klientów.
| właściwość automatyzacja interfejsu użytkownika | Wartość | Uwagi |
|---|---|---|
| NameProperty | Nieobsługiwany | Kontrolka menu nie wymaga ustawienia właściwości Name. |
| LabeledByProperty | Null |
Nie przewiduje się żadnej etykiety z typową kontrolką menu. |
| ControlTypeProperty | Menu | Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika. |
| IsContentElementProperty | Fałsz | Kontrolka menu nie jest uwzględniona w widoku zawartości drzewa automatyzacja interfejsu użytkownika. |
| IsControlElementProperty | Prawda | Kontrolka menu jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacja interfejsu użytkownika. |
Wymagane wzorce kontrolek automatyzacja interfejsu użytkownika
Nie ma wymaganych wzorców kontrolek dla typu kontrolki Menu.
Wymagane zdarzenia automatyzacja interfejsu użytkownika
Kontrolki menu muszą zostać wyświetlone MenuOpenedEvent po wyświetleniu na ekranie. Element MenuOpenedEvent będzie zawierać tekst kontrolki. MenuClosedEvent Element musi zostać podniesiony, gdy menu zniknie z ekranu.
W poniższej tabeli wymieniono zdarzenia automatyzacja interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki menu. Aby uzyskać więcej informacji na temat zdarzeń, zobacz omówienie zdarzeń automatyzacja interfejsu użytkownika.
| zdarzenie automatyzacja interfejsu użytkownika | Pomoc techniczna/wartość | Uwagi |
|---|---|---|
| MenuOpenedEvent | Wymagania | Brak |
| MenuClosedEvent | Wymagania | Brak |
| BoundingRectangleProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| IsOffscreenProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| IsEnabledProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| AutomationFocusChangedEvent | Wymagania | Brak |
| StructureChangedEvent | Wymagania | Brak |