Sdílet prostřednictvím

Typ ovládacího prvku ProgressBar

  • Článek

Toto téma obsahuje informace o podpoře automatizace uživatelského rozhraní microsoftu pro typ ovládacího prvku Progress Bar.

Ovládací prvky indikátoru průběhu označují průběh zdlouhavé operace. Ovládací prvek se skládá z obdélníku, který se postupně vyplní barvou zvýraznění systému při průběhu operace.

Následující části definují požadovanou strukturu stromu automatizace uživatelského rozhraní, vlastnosti, vzory ovládacích prvků a události pro typ ovládacího prvku Progress Bar. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky indikátoru průběhu, kde architektura uživatelského rozhraní nebo platforma integrují podporu automatizace uživatelského rozhraní pro typy ovládacích prvků a vzory ovládacích prvků.

Toto téma obsahuje následující části.

Typická stromová struktura

Následující tabulka znázorňuje typické zobrazení ovládacího prvku a obsahu stromu automatizace uživatelského rozhraní, které se týká ovládacích prvků indikátoru průběhu a popisuje, co může být obsaženo v jednotlivých zobrazeních. Další informace o stromu automatizace uživatelského rozhraní naleznete v tématu přehled stromu automatizace uživatelského rozhraní.

Zobrazení ovládacího prvku Zobrazení obsahu
  • ProgressBar
  • ProgressBar

Ovládací prvky indikátoru průběhu nemají v ovládacím prvku ani v zobrazení obsahu stromu automatizace uživatelského rozhraní žádné podřízené položky.

Relevantní vlastnosti

Následující tabulka uvádí vlastnosti automatizace uživatelského rozhraní, jejichž hodnota nebo definice jsou zvláště relevantní pro indikátory průběhu. Další informace o vlastnostech automatizace uživatelského rozhraní naleznete v tématu Načítání vlastností z prvků automatizace uživatelského rozhraní.

Vlastnost automatizace uživatelského rozhraní Hodnota Poznámky
UIA_AutomationIdPropertyId Viz poznámky. Hodnota této vlastnosti musí být jedinečná mezi všemi partnerskými prvky v nezpracovaného zobrazení stromu automatizace uživatelského rozhraní.
UIA_BoundingRectanglePropertyId Viz poznámky. Vnější obdélník, který obsahuje celý ovládací prvek.
UIA_ClickablePointPropertyId Viz poznámky. Podporuje se, pokud existuje ohraničující obdélník. Pokud ne každý bod uvnitř ohraničujícího obdélníku je možné kliknout a prvek provádí specializované testování hitů, přepište a poskytněte kliknutelný bod.
UIA_ControlTypePropertyId progressbar
UIA_IsContentElementPropertyId TRUE Ovládací prvek indikátoru průběhu je vždy součástí zobrazení obsahu stromu automatizace uživatelského rozhraní.
UIA_IsControlElementPropertyId TRUE Ovládací prvek indikátoru průběhu je vždy součástí zobrazení ovládacího prvku stromu automatizace uživatelského rozhraní.
UIA_IsKeyboardFocusablePropertyId Viz poznámky. Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat.
UIA_LabeledByPropertyId Viz poznámky. Pokud je popisek statického textu, musí tato vlastnost vystavit odkaz na tento ovládací prvek.
UIA_LocalizedControlTypePropertyId Viz poznámky. Lokalizovaný řetězec odpovídající ProgressBar typu ovládacího prvku. Výchozí hodnota je indikátor průběhu pro en-US nebo angličtinu (Spojené státy).
UIA_NamePropertyId Viz poznámky. Ovládací prvek indikátoru průběhu obvykle získá jeho název ze statického textového popisku. Pokud neexistuje statický textový popisek, vývojář aplikace musí zveřejnit hodnotu vlastnosti Name.

 

Požadované vzory ovládacích prvků

Následující tabulka uvádí vzory ovládacích prvků automatizace uživatelského rozhraní, které jsou potřeba k podpoře ovládacích prvků indikátoru průběhu. Další informace o vzorech ovládacích prvků najdete v tématu přehled vzorů ovládacích prvků automatizace uživatelského rozhraní.

Vlastnost vzoru ovládacího prvku nebo vzoru Podpora/hodnota Poznámky
IRangeValueProvider Závisí Ovládací prvky indikátoru průběhu, které přebírají číselný rozsah, musí implementovat řídicí vzor RangeValue.
minimální Závisí Hodnota této vlastnosti je minimální hodnota, kterou lze nastavit ovládací prvek. Tato hodnota by měla být menší než Maximální.
maximální Závisí Hodnota této vlastnosti je maximální hodnota, na kterou lze nastavit ovládací prvek. Tato hodnota by měla být větší než Minimální.
SmallChange NaN Tato vlastnost není nutná, protože ovládací prvky indikátoru průběhu jsou jen pro čtení.
LargeChange NaN Tato vlastnost není nutná, protože ovládací prvky indikátoru průběhu jsou jen pro čtení.
IValueProvider Závisí Ovládací prvky indikátoru průběhu, které poskytují textové označení průběhu, musí implementovat hodnotu vzor ovládacího prvku.
IsReadOnly TRUE Hodnota této vlastnosti je vždy TRUE.
hodnoty Viz poznámky. Tato vlastnost zveřejňuje textový průběh ovládacího prvku indikátoru průběhu.

 

Požadované události

Následující tabulka uvádí události automatizace uživatelského rozhraní, které jsou pro podporu indikátorů průběhu potřeba. Další informace o událostech najdete v tématu Přehled událostí automatizace uživatelského rozhraní.

Událost automatizace uživatelského rozhraní Poznámky
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId událost změněnou vlastností.
UIA_IsEnabledPropertyId událost změněnou vlastností. Pokud ovládací prvek podporuje vlastnost IsEnabled, musí tuto událost podporovat.
UIA_IsOffscreenPropertyId událost změněnou vlastností. Pokud ovládací prvek podporuje vlastnost IsOffscreen, musí tuto událost podporovat.
UIA_NamePropertyId událost změněnou vlastností.
UIA_StructureChangedEventId
UIA_RangeValueValuePropertyId událost změněnou vlastností. Pokud ovládací prvek podporuje RangeValue vzor ovládacího prvku, musí tuto událost podporovat.
UIA_ValueValuePropertyId událost změny vlastnosti. Pokud ovládací prvek podporuje vzor ovládacího prvku Hodnota, musí tuto událost podporovat.

 

koncepční

Přehled typů ovládacích prvků automatizace uživatelského rozhraní

Přehled automatizace uživatelského rozhraní