Obsługa automatyzacji interfejsu użytkownika dla kontrolek typu ProgressBar
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 ProgressBar. 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.
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 automatyzacja interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki ProgressBar. Wymagania dotyczące automatyzacja 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 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 paska postępu 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 |
|---|---|
| ProgressBar | ProgressBar |
Kontrolki paska postępu nie mają żadnych elementów podrzędnych w widoku kontrolki ani zawartości drzewa automatyzacja interfejsu użytkownika.
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 paska postępu. 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 | 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 | ProgressBar | Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika. |
| LocalizedControlTypeProperty | "pasek postępu" | Zlokalizowany ciąg odpowiadający typowi kontrolki ProgressBar. |
| IsContentElementProperty | Prawda | Kontrolka paska postępu jest zawsze uwzględniana w widoku zawartości drzewa automatyzacja interfejsu użytkownika. |
| IsControlElementProperty | Prawda | Kontrolka paska postępu jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacja interfejsu użytkownika. |
Wymagane wzorce i właściwości kontrolek automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono wzorce kontrolek automatyzacja interfejsu użytkownika wymagane do obsługi przez kontrolki paska postępu. 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/wzorzec kontrolki, właściwość | Pomoc techniczna/wartość | Uwagi |
|---|---|---|
| IValueProvider | Zależy | Kontrolki paska postępu, które dają tekstowe wskazanie postępu, muszą implementować IValueProviderelement . |
| 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 automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono zdarzenia automatyzacja interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki paska postępu. Aby uzyskać więcej informacji na temat zdarzeń, zobacz omówienie zdarzeń automatyzacja interfejsu użytkownika.
| zdarzenie automatyzacja interfejsu użytkownika | Pomoc techniczna | Uwagi |
|---|---|---|
| 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 |
| ValueProperty zdarzenie zmienione właściwości. | Zależy | Brak |
| AutomationFocusChangedEvent | Wymagania | Brak |
| StructureChangedEvent | Wymagania | Brak |