Obsługa automatyzacji interfejsu użytkownika dla kontrolek typu przycisk
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 Przycisk. 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ą określone wytyczne dotyczące struktury drzewa automatyzacja interfejsu użytkownika, automatyzacja interfejsu użytkownika wartości właściwości, wzorców kontrolek i zdarzeń automatyzacja interfejsu użytkownika.
Przycisk to obiekt, z którego użytkownik korzysta, aby wykonać akcję, taką jak PRZYCISK OK i Anuluj w oknie dialogowym. Kontrolka przycisku jest prostą kontrolką do uwidocznienia, ponieważ mapuje ją na pojedyncze polecenie, które użytkownik chce ukończyć.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacja interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki Przycisk. Wymagania dotyczące automatyzacja interfejsu użytkownika mają zastosowanie do wszystkich kontrolek przycisków, 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 przycisków 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 |
|---|---|
| Przycisk - Obraz (co najmniej 0) - Tekst (co najmniej 0) |
Przycisk |
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 implementujących typ kontrolki Przycisk (na przykład kontrolki przycisków). 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 |
|---|---|---|
| AcceleratorKeyProperty | Zobacz uwagi. | Kontrolka Przycisk zwykle musi obsługiwać klawisz akceleratora, aby umożliwić użytkownikowi końcowemu szybkie wykonywanie akcji reprezentowanej przez klawiaturę. |
| 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. |
| ControlTypeProperty | Przycisk | Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika. |
| HelpTextProperty | Zobacz uwagi. | Tekst pomocy może wskazywać, jaki będzie końcowy wynik aktywowania przycisku. Zazwyczaj jest to ten sam typ informacji przedstawionych za pomocą etykietki narzędzia. |
| IsContentElementProperty | Prawda | Kontrolka Przycisk musi zawsze być zawartością. |
| IsControlElementProperty | Prawda | Kontrolka Przycisk musi być zawsze kontrolką. |
| IsKeyboardFocusableProperty | Zobacz uwagi. | Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość. |
| LabeledByProperty | Null |
Kontrolki przycisków są oznaczone etykietą własną zawartością. |
| LocalizedControlTypeProperty | "przycisk" | Zlokalizowany ciąg odpowiadający typowi kontrolki Przycisk. |
| NameProperty | Zobacz uwagi. | Nazwa kontrolki przycisku to tekst używany do etykietowania. Za każdym razem, gdy obraz jest używany do etykietowania przycisku, należy podać alternatywny tekst dla właściwości Name przycisku. |
Wymagane wzorce kontrolek automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono wzorce kontrolek automatyzacja interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki przycisków. 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 | Zobacz uwagi. | Wszystkie przyciski powinny obsługiwać wzorzec kontrolki Wywołaj lub wzorzec kontrolki Przełącz. Wywołanie jest obsługiwane, gdy przycisk wykonuje polecenie na żądanie użytkownika. To polecenie mapuje na jedną operację, taką jak wycinanie, kopiowanie, wklejanie lub usuwanie. |
| IToggleProvider | Zobacz uwagi. | Wszystkie przyciski powinny obsługiwać wzorzec kontrolki Wywołaj lub wzorzec kontrolki Przełącz. Przełącznik jest obsługiwany, jeśli przycisk może być cyklowany przez serię maksymalnie trzech stanów. Zazwyczaj jest to postrzegane jako przełącznik włączony/wyłączony dla określonych funkcji. |
| IExpandCollapseProvider | Zobacz uwagi. | Gdy przycisk jest hostowany jako element podrzędny przycisku podziału, przycisk podrzędny może obsługiwać wzorzec ExpandCollapse zamiast wzorca Invoke lub Toggle. Wzorzec ExpandCollapse może służyć do otwierania lub zamykania menu lub innej struktury podrzędnej skojarzonej z elementem przycisku. |
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. Aby uzyskać więcej informacji na temat zdarzeń, zobacz omówienie zdarzeń automatyzacja interfejsu użytkownika.
| zdarzenie automatyzacja interfejsu użytkownika | Pomoc techniczna | Uwagi |
|---|---|---|
| AutomationFocusChangedEvent | 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 |
| NameProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| StructureChangedEvent | Wymagania | Brak |
| InvokedEvent | Zależy | Jeśli kontrolka obsługuje wzorzec kontrolki Invoke, musi obsługiwać to zdarzenie. |
| ToggleStateProperty zdarzenie zmienione właściwości. | Zależy | Jeśli kontrolka obsługuje wzorzec kontrolki Przełączanie, musi obsługiwać to zdarzenie. |