Obsługa automatyzacji interfejsu użytkownika dla typu formantu MenuBar
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 dla typu kontrolkiMenuBar. W automatyzacja interfejsu użytkownika typ kontrolki jest zestawem warunków, które musi spełniać kontrolka ControlTypeProperty w celu użycia właściwości . Warunki obejmują konkretne wytyczne dotyczące struktury drzewa automatyzacja interfejsu użytkownika, automatyzacja interfejsu użytkownika wartości właściwości i wzorce kontrolek.
Kontrolki paska menu to przykład kontrolek implementujących typ kontrolki MenuBar. Paski menu umożliwiają użytkownikom aktywowanie poleceń i opcji zawartych w aplikacji.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacja interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki MenuBar. 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 paska 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 |
|---|---|
| Menubar - MenuItem (co najmniej 1) - Inne kontrolki (0 lub wiele) |
Menubar - MenuItem (co najmniej 1) - Inne kontrolki (0 lub wiele) |
Kontrolki paska menu mogą zawierać inne kontrolki, takie jak kontrolki edycji i pola kombi w jego strukturze. Te dodatkowe kontrolki odpowiadają "innym kontrolkom" wymienionym powyżej w widokach kontrolki i zawartości.
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 kontrolek paska 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 |
|---|---|---|
| BoundingRectangleProperty | Zobacz uwagi. | Wartość uwidoczniona przez tę właściwość musi zawierać wszystkie zawarte w niej kontrolki. |
| NameProperty | Zobacz uwagi. | Kontrolka paska menu nie wymaga nazwy, chyba że aplikacja ma więcej niż jeden pasek menu. Jeśli w aplikacji znajduje się więcej niż jeden pasek menu, ta właściwość powinna służyć do uwidaczniania nazw wyróżniających, takich jak "Formatowanie" lub "Tworzenie konspektacji". |
| LabeledByProperty | Null |
Kontrolki paska menu nigdy nie mają etykiety. |
| ControlTypeProperty | Menubar | Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika. |
| LocalizedControlTypeProperty | "pasek menu" | Zlokalizowany ciąg odpowiadający typowi kontrolki MenuBar. |
| IsContentElementProperty | Prawda | Kontrolka paska menu jest zawsze uwzględniana w widoku zawartości drzewa automatyzacja interfejsu użytkownika. |
| IsControlElementProperty | Prawda | Kontrolka paska menu jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacja interfejsu użytkownika. |
| IsOffscreenProperty | Zobacz uwagi. | Wartość tej właściwości zależy od tego, czy kontrolka jest widoczna na ekranie. |
| OrientationProperty | Zależy | Ta właściwość uwidacznia, czy kontrolka paska menu jest pozioma, czy pionowa. |
| IsKeyboardFocusableProperty | Prawda | Kontrolki paska menu można skupić na klawiaturze, ponieważ kontrolki, które zawierają, mogą skupić się na klawiaturze. |
| HelpTextProperty | Zobacz uwagi. | Brak scenariuszy, w których tekst Pomocy jest wymagany dla kontrolki paska menu. |
| AcceleratorKeyProperty | Null |
Paski menu nigdy nie mają klawiszy akceleratora. |
| AccessKeyProperty | "ALT" | Naciśnięcie klawisza ALT powinno zawsze koncentrować się na pasku menu w aplikacji. |
Wymagane wzorce kontrolek automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono wzorce kontrolek automatyzacja interfejsu użytkownika wymagane do obsługi przez kontrolki paska menu. Aby uzyskać więcej informacji na temat wzorców kontrolek, zobacz automatyzacja interfejsu użytkownika Control Patterns Overview (Omówienie wzorców kontrolek automatyzacja interfejsu użytkownika).
| Wzorzec kontrolki | Pomoc techniczna | Uwagi |
|---|---|---|
| IExpandCollapseProvider | Zależy | Jeśli kontrolkę można rozwinąć lub zwinąć, zaimplementuj element IExpandCollapseProvider. |
| IDockProvider | Zależy | Jeśli kontrolkę można zadokować do różnych części ekranu, zaimplementuj IDockProviderelement . |
| ITransformProvider | Zależy | Jeśli można zmienić rozmiar kontrolki, obrócony lub przeniesiony musi zaimplementować element ITransformProvider. |
Wymagane zdarzenia automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono zdarzenia automatyzacja interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki paska 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 |
|---|---|---|
| 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 |
| ExpandCollapseStateProperty zdarzenie zmienione właściwości. | Zależy | Brak |
| AutomationFocusChangedEvent | Wymagania | Brak |
| StructureChangedEvent | Wymagania | Brak |