Udostępnij za pomocą

Obsługa automatyzacji interfejsu użytkownika dla typu kontrolki ProgressBar

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 ProgressBar. 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.

Kontrolki paska postępu to przykład kontrolek implementujących typ kontrolki ProgressBar. Kontrolki paska postępu służą do wskazywania postępu długotrwałej operacji. Kontrolka składa się z prostokąta, który jest stopniowo wypełniony kolorem wyróżnienia systemu w miarę postępu operacji.

W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki ProgressBar. Wymagania automatyzacji 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 automatyzacji interfejsu użytkownika

W poniższej tabeli przedstawiono widok kontrolki i widok zawartości drzewa automatyzacji interfejsu użytkownika odnoszącego się do kontrolek paska postępu 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
Pasek postępu Pasek postępu

Kontrolki paska postępu nie mają żadnych elementów podrzędnych w widoku kontrolki ani zawartości drzewa automatyzacji interfejsu użytkownika.

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 paska postępu. 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 Zobacz uwagi. Kontrolka paska postępu zwykle pobiera nazwę ze statycznej etykiety tekstowej. Jeśli nie ma statycznej etykiety tekstowej, deweloper aplikacji musi uwidocznić wartość właściwości Name .
LabeledByProperty Zobacz uwagi. Jeśli istnieje statyczna etykieta tekstowa, ta właściwość musi uwidocznić odwołanie do tej kontrolki.
ControlTypeProperty Pasek postępu Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika.
LocalizedControlTypeProperty "pasek postępu" Zlokalizowany ciąg znaków odpowiadający typowi kontrolki ProgressBar.
IsContentElementProperty Prawda Kontrolka paska postępu jest zawsze uwzględniana w widoku zawartości drzewa automatyzacji interfejsu użytkownika.
IsControlElementProperty Prawda Kontrolka paska postępu jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacji interfejsu użytkownika.

Wymagane wzorce i właściwości kontrolki automatyzacji interfejsu użytkownika

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

Wzorzec/wzorzec kontrolki, właściwość Pomoc techniczna/wartość Notatki
IValueProvider Zależy Kontrolki paska postępu, które tekstowo wskazują postęp, muszą implementować IValueProvider.
IsReadOnly Prawda Wartość tej właściwości jest zawsze True.
Value Zobacz uwagi. Ta właściwość uwidacznia tekstowy postęp kontrolki paska postępu.
IRangeValueProvider Zależy Kontrolki paska postępu, które przyjmują zakres liczbowy, muszą implementować IRangeValueProvider
Minimum 0,0 Wartość tej właściwości jest najmniejszą wartością, którą można ustawić dla kontrolki.
Maximum 100,0 Wartość tej właściwości jest największą wartością, którą można ustawić dla kontrolki.
SmallChange Nan Ta właściwość nie jest wymagana, ponieważ kontrolki paska postępu są tylko do odczytu.
LargeChange Nan Ta właściwość nie jest wymagana, ponieważ kontrolki paska postępu są tylko do odczytu.

Wymagane zdarzenia automatyzacji interfejsu użytkownika

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

Zdarzenie automatyzacji interfejsu użytkownika Wsparcie Notatki
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
ValueProperty zdarzenie zmiany właściwości. Zależy Żaden
AutomationFocusChangedEvent Wymagane Żaden
StructureChangedEvent Wymagane Żaden

Zobacz także

  • Last updated on