Sdílet prostřednictvím


Podpora automatizace uživatelského rozhraní pro typ ovládacího prvku ProgressBar

Poznámka:

Tato dokumentace je určená pro vývojáře rozhraní .NET Framework, kteří chtějí používat spravované třídy automatizace uživatelského rozhraní definované v oboru názvů System.Windows.Automation. Nejnovější informace o automatizaci uživatelského rozhraní najdete v tématu rozhraní API služby Windows Automation: Automatizace uživatelského rozhraní.

Toto téma obsahuje informace o podpoře automatizace uživatelského rozhraní pro typ ovládacího prvku ProgressBar. V automatizaci uživatelského rozhraní je typ ovládacího prvku sadou podmínek, které musí ovládací prvek splnit, aby bylo možné vlastnost použít ControlTypeProperty . Tyto podmínky zahrnují specifické pokyny pro stromovou strukturu automatizace uživatelského rozhraní, hodnoty vlastností automatizace uživatelského rozhraní, vzory ovládacích prvků a události automatizace uživatelského rozhraní.

Ovládací prvky indikátoru průběhu jsou příkladem ovládacích prvků, které implementují typ ovládacího prvku ProgressBar. Indikátory průběhu se používají pro označení průběhu 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 stromovou strukturu automatizace uživatelského rozhraní, vlastnosti, vzory ovládacích prvků a události pro typ ovládacího prvku ProgressBar. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky seznamu, ať už windows Presentation Foundation (WPF), Win32 nebo Windows Forms.

Požadovaná struktura stromu automatizace uživatelského rozhraní

Následující tabulka znázorňuje zobrazení ovládacích prvků a zobrazení 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í najdete 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.

Požadované vlastnosti automatizace uživatelského rozhraní

Následující tabulka uvádí vlastnosti automatizace uživatelského rozhraní, jejichž hodnota nebo definice jsou zvláště relevantní pro ovládací prvky indikátoru průběhu. Další informace o vlastnostech automatizace uživatelského rozhraní naleznete v tématu Vlastnosti automatizace uživatelského rozhraní pro klienty.

Vlastnost automatizace uživatelského rozhraní Hodnota Poznámky
AutomationIdProperty Viz poznámky. Hodnota této vlastnosti musí být jedinečná pro všechny ovládací prvky v aplikaci.
BoundingRectangleProperty Viz poznámky. Vnější obdélník, který obsahuje celý ovládací prvek.
ClickablePointProperty Viz poznámky. Podporuje se, pokud existuje ohraničující obdélník. Pokud není každý bod uvnitř ohraničujícího obdélníku kliknutelný a provádíte specializované testování zásahů, můžete přepsat a poskytnout kliknutelný bod.
IsKeyboardFocusableProperty Viz poznámky. Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat.
NameProperty Viz poznámky. Ovládací prvek indikátoru průběhu obvykle získá jeho název ze statického textového popisku. Pokud není popisek statického textu, vývojář aplikace musí zveřejnit hodnotu vlastnosti Name .
LabeledByProperty Viz poznámky. Pokud je popisek statického textu, musí tato vlastnost vystavit odkaz na tento ovládací prvek.
ControlTypeProperty ProgressBar Tato hodnota je stejná pro všechny architektury uživatelského rozhraní.
LocalizedControlTypeProperty "indikátor průběhu" Lokalizovaný řetězec odpovídající typu ovládacího prvku ProgressBar.
IsContentElementProperty Pravdivé Ovládací prvek indikátoru průběhu je vždy součástí zobrazení obsahu stromu automatizace uživatelského rozhraní.
IsControlElementProperty Pravdivé Ovládací prvek indikátoru průběhu je vždy součástí zobrazení ovládacího prvku stromu automatizace uživatelského rozhraní.

Požadované vzory a vlastnosti ovládacích prvků automatizace uživatelského rozhraní

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
IValueProvider Závisí Ovládací prvky indikátoru průběhu, které poskytují textové označení průběhu, musí implementovat IValueProvider.
IsReadOnly Pravdivé Hodnota této vlastnosti je vždy True.
Value Viz poznámky. Tato vlastnost zveřejňuje textový průběh ovládacího prvku indikátoru průběhu.
IRangeValueProvider Závisí Ovládací prvky indikátoru průběhu, které přebírají číselný rozsah, musí implementovat IRangeValueProvider
Minimum 0,0 Hodnota této vlastnosti je nejmenší hodnota, kterou lze nastavit ovládací prvek.
Maximum 100.0 Hodnota této vlastnosti je největší hodnotou, na kterou lze nastavit ovládací prvek.
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í.

Požadované události automatizace uživatelského rozhraní

Následující tabulka uvádí události automatizace uživatelského rozhraní, které musí podporovat všechny ovládací prvky indikátoru průběhu. 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í Podpora Poznámky
BoundingRectangleProperty událost změny vlastnosti. Povinné Žádné
IsOffscreenProperty událost změny vlastnosti. Povinné Žádné
IsEnabledProperty událost změny vlastnosti. Povinné Žádné
NameProperty událost změny vlastnosti. Povinné Žádné
ValueProperty událost změny vlastnosti. Závisí Žádné
AutomationFocusChangedEvent Povinné Žádné
StructureChangedEvent Povinné Žádné

Viz také

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