ProgressBar, typ kontrolki
Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika firmy Microsoft dla ProgressBar typu kontrolki.
Kontrolki paska postępu wskazują postęp długiej 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 ProgressBar typu kontrolki. Wymagania automatyzacji interfejsu użytkownika mają zastosowanie do wszystkich kontrolek paska postępu, w których platforma/platforma interfejsu użytkownika integruje obsługę automatyzacji interfejsu użytkownika dla typów kontrolek i wzorców kontrolek.
Ten temat zawiera następujące sekcje.
- typowa struktura drzewa
- odpowiednie właściwości
- wymagane wzorce kontrolek
- wymagane zdarzenia
- Tematy pokrewne
Typowa struktura drzewa
W poniższej tabeli przedstawiono typowy widok kontrolki i 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 kontrolki | Widok zawartości |
|---|---|
|
|
Kontrolki paska postępu nie mają żadnych elementów podrzędnych w widoku kontrolki ani zawartości drzewa automatyzacji interfejsu użytkownika.
Odpowiednie właściwości
W poniższej tabeli wymieniono właściwości automatyzacji interfejsu użytkownika, których wartość lub definicja jest szczególnie istotna dla pasków postępu. Aby uzyskać więcej informacji na temat właściwości automatyzacji interfejsu użytkownika, zobacz Pobieranie właściwości z elementów automatyzacji interfejsu użytkownika.
| Właściwość automatyzacji interfejsu użytkownika | Wartość | Notatki |
|---|---|---|
| UIA_AutomationIdPropertyId | Zobacz uwagi. | Wartość tej właściwości musi być unikatowa wśród wszystkich elementów równorzędnych w nieprzetworzonym widoku drzewa automatyzacji interfejsu użytkownika. |
| UIA_BoundingRectanglePropertyId | Zobacz uwagi. | Najbardziej oddalony prostokąt, który zawiera całą kontrolkę. |
| UIA_ClickablePointPropertyId | Zobacz uwagi. | Obsługiwane, jeśli istnieje prostokąt ograniczenia. Jeśli nie każdy punkt w obrębie prostokąta ograniczenia jest klikalny, a element wykonuje wyspecjalizowane testowanie trafień, przesłonięć i zapewnić punkt możliwy do kliknięcia. |
| UIA_ControlTypePropertyId | ProgressBar | |
| UIA_IsContentElementPropertyId | true | Kontrolka paska postępu jest zawsze uwzględniana w widoku zawartości drzewa automatyzacji interfejsu użytkownika. |
| UIA_IsControlElementPropertyId | true | Kontrolka paska postępu jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacji interfejsu użytkownika. |
| UIA_IsKeyboardFocusablePropertyId | Zobacz uwagi. | Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość. |
| UIA_LabeledByPropertyId | Zobacz uwagi. | Jeśli istnieje statyczna etykieta tekstowa, ta właściwość musi uwidocznić odwołanie do tej kontrolki. |
| UIA_LocalizedControlTypePropertyId | Zobacz uwagi. | Zlokalizowany ciąg odpowiadający ProgressBar typ kontrolki. Wartość domyślna to "pasek postępu" dla en-US lub angielski (Stany Zjednoczone). |
| UIA_NamePropertyId | 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. |
Wymagane wzorce kontrolek
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 |
|---|---|---|
| IRangeValueProvider | Zależy | Kontrolki paska postępu, które przyjmują zakres liczbowy, muszą implementować wzorzec kontrolki RangeValue. |
| minimalna | Zależy | Wartość tej właściwości jest minimalną wartością, którą można ustawić dla kontrolki. Ta wartość powinna być mniejsza niż maksymalna. |
| maksymalna | Zależy | Wartość tej właściwości jest maksymalną wartością, którą można ustawić dla kontrolki. Ta wartość powinna być większa niż wartość minimalna . |
| 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. |
| IValueProvider | Zależy | Kontrolki paska postępu, które dają tekstowe wskazanie postępu, muszą implementować wzorzec kontrolki Value. |
| IsReadOnly | true | Wartość tej właściwości jest zawsze true. |
| wartości | Zobacz uwagi. | Ta właściwość uwidacznia tekstowy postęp kontrolki paska postępu. |
Zdarzenia wymagane
W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika wymagane do obsługi pasków postępu. Aby uzyskać więcej informacji na temat zdarzeń, zobacz Omówienie zdarzeń automatyzacji interfejsu użytkownika.
| Zdarzenie automatyzacji interfejsu użytkownika | Notatki |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId zdarzenie zmienione właściwości. | |
| UIA_IsEnabledPropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje właściwość IsEnabled, musi obsługiwać to zdarzenie. |
| UIA_IsOffscreenPropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje właściwość IsOffscreen, musi obsługiwać to zdarzenie. |
| UIA_NamePropertyId zdarzenie zmienione właściwości. | |
| UIA_StructureChangedEventId | |
| UIA_RangeValueValuePropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki RangeValue, musi obsługiwać to zdarzenie. |
| UIA_ValueValuePropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki Value, musi obsługiwać to zdarzenie. |
Tematy pokrewne