Udostępnij za pomocą

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

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 automatyzacji interfejsu użytkownika (UI Automation) dla kontrolki typu Przycisk. 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ą określone wytyczne dotyczące struktury drzewa automatyzacji interfejsu użytkownika, wartości właściwości automatyzacji interfejsu użytkownika, wzorców kontrolek i zdarzeń automatyzacji 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 automatyzacji UI, właściwości, schematy kontrolek i zdarzenia dla typu kontrolki przycisku. Wymagania automatyzacji 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 automatyzacji interfejsu użytkownika

W poniższej tabeli przedstawiono widok kontrolki i widok zawartości drzewa automatyzacji interfejsu użytkownika odnoszące się do kontrolek przycisków 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
Przycisk

- Obraz (0 lub więcej)
- Tekst (0 lub więcej)		 Przycisk

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 kontrolek implementujących typ kontrolki Przycisk (na przykład kontrolki przycisków). 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
AcceleratorKeyProperty Zobacz uwagi. Kontrolka Przycisk zwykle musi obsługiwać klawisz skrótu, aby umożliwić użytkownikowi końcowemu szybkie wykonywanie akcji z klawiatury.
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.
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 zawierać zawartość.
IsControlElementProperty Prawda Kontrolka Przycisk powinna zawsze być 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 tekstowy 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 automatyzacji interfejsu użytkownika

W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika wymagane do obsługi wszystkich kontrolek przycisków. Aby uzyskać więcej informacji na temat wzorców kontrolek, zobacz Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie.

Wzorzec kontrolki Wsparcie Notatki
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 przechodzić przez maksymalnie trzy stany. 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 automatyzacji interfejsu użytkownika

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

Zdarzenie automatyzacji interfejsu użytkownika Wsparcie Notatki
AutomationFocusChangedEvent 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
NameProperty zdarzenie zmiany właściwości. Wymagane Żaden
StructureChangedEvent Wymagane Żaden
InvokedEvent Zależy Jeśli kontrolka obsługuje wzorzec kontrolki Invoke, musi obsługiwać to zdarzenie.
ToggleStateProperty zdarzenie zmiany właściwości. Zależy Jeśli kontrolka obsługuje wzorzec kontrolki Przełączanie, musi obsługiwać to zdarzenie.

Zobacz także

  • Last updated on