Obsługa automatyzacji interfejsu użytkownika dla kontrolek typu SplitButton
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 kontrolki SplitButton. 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.
Kontrolka przycisku podziału umożliwia wykonywanie akcji na kontrolce i rozwijanie kontrolki w celu wyświetlenia listy innych możliwych akcji, które można wykonać.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacja interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki SplitButton. Wymagania dotyczące automatyzacja interfejsu użytkownika mają zastosowanie do wszystkich kontrolek przycisków podzielonych, 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ące się do kontrolek przycisku podziału 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 |
|---|---|
Splitbutton
|
Splitbutton - MenuItem (od 1 do wielu) |
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 istotne dla kontrolek przycisków podziału. 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 |
|---|---|---|
| AutomationIdProperty | Zobacz uwagi. | Wartość tej właściwości musi być unikatowa we wszystkich kontrolkach w aplikacji. |
| BoundingRectangleProperty | Zobacz uwagi. | Najbardziej oddalony prostokąt, który zawiera całą kontrolkę. |
| ClickablePointProperty | Zobacz uwagi. | Obsługiwane, jeśli istnieje prostokąt ograniczenia. Jeśli nie każdy punkt w prostokątze ograniczenia jest klikalny, i wykonujesz wyspecjalizowane testowanie trafień, przesłoń i zapewnia punkt możliwy do kliknięcia. |
| IsKeyboardFocusableProperty | Zobacz uwagi. | Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość. |
| NameProperty | "Wstecz" | Nazwa kontrolki przycisku podziału jest wyświetlana na przycisku. |
| LabeledByProperty | Null (zero) | Kontrolki przycisku podziału nie mają statycznej etykiety tekstowej. |
| ControlTypeProperty | Splitbutton | Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika. |
| LocalizedControlTypeProperty | "Przycisk podziału" | Zlokalizowany ciąg odpowiadający typowi kontrolki SplitButton. |
| HelpTextProperty | Zobacz uwagi. | Tekst pomocy może wskazywać wynik aktywowania przycisku podziału, który jest zazwyczaj tego samego typu informacjami przedstawionymi za pomocą etykietki narzędzia. |
| IsContentElementProperty | Prawda | Kontrolka przycisku podziału zawiera informacje dla użytkownika końcowego. |
| IsControlElementProperty | Prawda | Kontrolka przycisku podziału jest widoczna dla użytkownika końcowego. |
Wymagane wzorce kontrolek automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono wzorce kontrolek automatyzacja interfejsu użytkownika wymagane do obsługi przez kontrolki przycisku podziału. 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 |
|---|---|---|
| IInvokeProvider | Wymagania | Przyciski podziału zawsze mają domyślną akcję skojarzona z wywołaniami. |
| IExpandCollapseProvider | Wymagania | Przyciski podziału zawsze mają możliwość rozwinięcia listy opcji. |
Wymagane zdarzenia automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono zdarzenia automatyzacja interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki przycisków podziału. Aby uzyskać więcej informacji na temat zdarzeń, zobacz omówienie zdarzeń automatyzacja interfejsu użytkownika.
| zdarzenie automatyzacja interfejsu użytkownika | Pomoc techniczna | Uwagi |
|---|---|---|
| InvokedEvent | 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 |
| ExpandCollapseStateProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| AutomationFocusChangedEvent | Wymagania | Brak |
| StructureChangedEvent | Wymagania | Brak |
Przykład kontrolki SplitButton
Na poniższej ilustracji przedstawiono typ kontrolki SplitButton w kontrolce siatki danych.
Poniżej zostanie wyświetlony widok kontrolki i widok zawartości drzewa automatyzacja interfejsu użytkownika odnoszącego się do siatki danych i kontrolki przycisku podziału. Wzorce sterowania dla każdego elementu automatyzacji są wyświetlane w nawiasach.
| drzewo automatyzacja interfejsu użytkownika — widok sterowania | drzewo automatyzacja interfejsu użytkownika — widok zawartości |
|---|---|
|
|