Udostępnij przez

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

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

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.

 

koncepcyjne

typy kontrolek automatyzacji interfejsu użytkownika — omówienie

Omówienie automatyzacji interfejsu użytkownika

 

 

  • Last updated on