Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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 dla typu kontrolki SplitButton. W Automatyzacji interfejsu użytkownika typ kontrolki jest zestawem warunków, które musi spełniać kontrolka, aby korzystać z właściwości ControlTypeProperty. Warunki obejmują konkretne wytyczne dotyczące struktury drzewa automatyzacji interfejsu użytkownika, wartości właściwości automatyzacji interfejsu użytkownika i wzorców 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 automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki SplitButton. Wymagania automatyzacji 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 automatyzacji interfejsu użytkownika
W poniższej tabeli przedstawiono widok kontrolki i widok zawartości drzewa automatyzacji interfejsu użytkownika odnoszący się do kontrolek przycisków podziału 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 |
|---|---|
SplitButton
|
SplitButton - ElementMenu (od 1 do wielu) |
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 są szczególnie istotne dla kontrolek przycisku rozwijalnego. 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 |
|---|---|---|
| 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ącie ograniczającym jest klikalny i wykonujesz wyspecjalizowane testowanie trafień, zapewnij punkt, który jest 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 | 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 automatyzacji interfejsu użytkownika
W poniższej tabeli wymieniono wzorce automatyzacji interfejsu użytkownika wymagane do obsługi przez kontrolki przycisków podziału. Aby uzyskać więcej informacji na temat wzorców elementów sterujących, zajrzyj do Omówienie wzorców automatyzacji interfejsu użytkownika.
| Wzorzec kontrolki | Wsparcie | Notatki |
|---|---|---|
| IInvokeProvider | Wymagane | Przyciski podziału zawsze mają domyślną akcję skojarzoną z wywołaniem. |
| IExpandCollapseProvider | Wymagane | Przyciski podziału zawsze mają możliwość rozwinięcia listy opcji. |
Wymagane zdarzenia automatyzacji interfejsu użytkownika
W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika wymagane do obsługi wszystkich kontrolek przycisków podziału. Aby uzyskać więcej informacji na temat zdarzeń, zobacz Omówienie zdarzeń automatyzacji interfejsu użytkownika.
| Zdarzenie automatyzacji interfejsu użytkownika | Wsparcie | Notatki |
|---|---|---|
| InvokedEvent | 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 |
| ExpandCollapseStateProperty zdarzenie zmiany właściwości. | Wymagane | Żaden |
| AutomationFocusChangedEvent | Wymagane | Żaden |
| StructureChangedEvent | Wymagane | Żaden |
Przykład kontrolki SplitButton
Na poniższej ilustracji przedstawiono typ kontrolki SplitButton w kontrolce siatki danych.
Widok kontrolny i widok treści drzewa automatyzacji interfejsu użytkownika, które odnoszą się do siatki danych i przycisków dzielonych, są wyświetlane poniżej. Wzorce sterowania dla każdego elementu automatyzacji są wyświetlane w nawiasach.
| Drzewo automatyzacji interfejsu użytkownika — widok sterowania | Drzewo automatyzacji interfejsu użytkownika — widok zawartości |
|---|---|
|
|
Zobacz także
- SplitButton
- typy kontrolek automatyzacji interfejsu użytkownika — omówienie
- Omówienie automatyzacji interfejsu użytkownika