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 model UI Automation definované v System.Windows.Automation oboru názvů. Nejnovější informace o model UI Automation najdete v tématu Rozhraní API služby Windows Automation: model UI Automation.
Toto téma obsahuje informace o podpoře model UI Automation pro typ ovládacího prvku ProgressBar. V model UI Automation je typ ovládacího prvku sadou podmínek, které musí ovládací prvek splňovat, aby bylo možné vlastnost použítControlTypeProperty. Mezi tyto podmínky patří specifické pokyny pro strukturu stromové struktury model UI Automation, hodnoty vlastností model UI Automation, vzory ovládacích prvků a události model UI Automation.
Ovládací prvky indikátoru průběhu jsou příkladem ovládacích prvků, které implementují typ ovládacího prvku ProgressBar. Ovládací prvky indikátoru průběhu slouží k 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 model UI Automation stromovou strukturu, vlastnosti, vzory ovládacích prvků a události pro typ ovládacího prvku ProgressBar. Požadavky na model UI Automation platí pro všechny ovládací prvky seznamu, ať už windows Presentation Foundation (WPF), Win32 nebo model Windows Forms.
Požadovaná struktura stromu model UI Automation
Následující tabulka znázorňuje zobrazení ovládacích prvků a zobrazení obsahu stromu model UI Automation, 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 model UI Automation naleznete v tématu model UI Automation Strom přehledu.
| 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 model UI Automation stromu žádné podřízené položky.
Požadované vlastnosti model UI Automation
Následující tabulka uvádí model UI Automation vlastnosti, jejichž hodnota nebo definice jsou zvláště relevantní pro ovládací prvky indikátoru průběhu. Další informace o model UI Automation vlastnosti naleznete v tématu model UI Automation Vlastnosti pro klienty.
| vlastnost model UI Automation | Hodnota | Notes |
|---|---|---|
| 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 ne každý bod uvnitř ohraničujícího obdélníku je možné kliknout a provést specializované testování hitů, pak 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 | True | Ovládací prvek indikátoru průběhu je vždy součástí zobrazení obsahu stromu model UI Automation. |
| IsControlElementProperty | True | Ovládací prvek indikátoru průběhu je vždy součástí zobrazení ovládacího prvku stromu model UI Automation. |
Požadované vzory a vlastnosti ovládacích prvků model UI Automation
Následující tabulka uvádí model UI Automation vzory ovládacích prvků vyžadované ovládacími prvky indikátoru průběhu. Další informace o vzorech ovládacích prvků najdete v tématu model UI Automation Přehled vzorů ovládacích prvků.
| Vlastnost vzoru ovládacího prvku nebo vzoru | Podpora/hodnota | Notes |
|---|---|---|
| IValueProvider | Závisí | Ovládací prvky indikátoru průběhu, které poskytují textové označení průběhu, musí implementovat IValueProvider. |
| IsReadOnly | True | 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 | Není číslo | Tato vlastnost není nutná, protože ovládací prvky indikátoru průběhu jsou jen pro čtení. |
| LargeChange | Není číslo | Tato vlastnost není nutná, protože ovládací prvky indikátoru průběhu jsou jen pro čtení. |
Požadované události model UI Automation
Následující tabulka uvádí model UI Automation události, které musí být podporovány všemi ovládacími prvky indikátoru průběhu. Další informace o událostech najdete v tématu model UI Automation Přehled událostí.
| událost model UI Automation | Technická podpora | Notes |
|---|---|---|
| BoundingRectangleProperty událost změněná vlastností. | Požaduje se | Nic |
| IsOffscreenProperty událost změněná vlastností. | Požaduje se | Nic |
| IsEnabledProperty událost změněná vlastností. | Požaduje se | Nic |
| NameProperty událost změněná vlastností. | Požaduje se | Nic |
| ValueProperty událost změněná vlastností. | Závisí | Nic |
| AutomationFocusChangedEvent | Požaduje se | Nic |
| StructureChangedEvent | Požaduje se | Nic |