Obsługa automatyzacji interfejsu użytkownika dla kontrolek typu menu

Uwaga / Notatka

Ta dokumentacja jest przeznaczona dla deweloperów programu .NET Framework, którzy chcą używać zarządzanych klas automatyzacji interfejsu użytkownika zdefiniowanych w przestrzeni nazw System.Windows.Automation. Aby uzyskać najnowsze informacje na temat automatyzacji interfejsu użytkownika, zobacz Windows Automation API: Automatyzacja interfejsu użytkownika.

Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika firmy Microsoft dla typu kontrolki Menu. Opisuje strukturę drzewa automatyzacji interfejsu użytkownika Microsoft oraz zawiera właściwości i wzorce kontrolki 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, 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 typu kontrolki Menu. Wymagania automatyzacji 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 automatyzacji interfejsu użytkownika

W poniższej tabeli przedstawiono widok kontrolki i widok zawartości drzewa automatyzacji 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 automatyzacji interfejsu użytkownika, zobacz Omówienie drzewa automatyzacji interfejsu użytkownika.

Widok sterowania	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 automatyzacji interfejsu użytkownika. Typy kontrolek menu powinny być wyświetlane pod tą kontrolką, której dotyczą informacje. Klienci automatyzacji interfejsu użytkownika 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 automatyzacji interfejsu użytkownika

W poniższej tabeli wymieniono właściwości automatyzacji 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 automatyzacji interfejsu użytkownika, zobacz Właściwości automatyzacji interfejsu użytkownika dla klientów.

Właściwość automatyzacji interfejsu użytkownika	Wartość	Notatki
NameProperty	Nie jest obsł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	Nieprawda	Kontrolka menu nie jest uwzględniona w widoku zawartości drzewa automatyzacji interfejsu użytkownika.
IsControlElementProperty	Prawda	Kontrolka menu jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacji interfejsu użytkownika.

Wymagane wzorce kontrolek automatyzacji interfejsu użytkownika

Nie ma wymaganych wzorców kontrolek dla typu kontrolki Menu.

Wymagane zdarzenia automatyzacji interfejsu użytkownika

Kontrolki menu muszą generować MenuOpenedEvent po pojawieniu się na ekranie. Element MenuOpenedEvent będzie zawierać tekst kontrolki. Element MenuClosedEvent musi być aktywowany, gdy menu zniknie z ekranu.

W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika wymagane do obsługi wszystkich kontrolek menu. Aby uzyskać więcej informacji na temat zdarzeń, zobacz Omówienie zdarzeń automatyzacji interfejsu użytkownika.

Zdarzenie automatyzacji interfejsu użytkownika	Pomoc techniczna/wartość	Notatki
MenuOpenedEvent	Wymagane	Żaden
MenuClosedEvent	Wymagane	Żaden
BoundingRectangleProperty zdarzenie zmiany właściwości.	Wymagane	Żaden
IsOffscreenProperty zdarzenie zmiany właściwości.	Wymagane	Żaden
IsEnabledProperty zdarzenie zmiany właściwości.	Wymagane	Żaden
AutomationFocusChangedEvent	Wymagane	Żaden
StructureChangedEvent	Wymagane	Żaden

Zobacz także

• Menu
• Omówienie wzorców automatyzacji kontrolek interfejsu użytkownika
• typy kontrolek automatyzacji interfejsu użytkownika — omówienie
• Omówienie automatyzacji interfejsu użytkownika