Podpora automatizace uživatelského rozhraní pro typ ovládacího prvku ScrollBar
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 ScrollBar. 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. Podmínky zahrnují specifické pokyny pro strukturu stromové struktury model UI Automation, model UI Automation hodnoty vlastností a vzory ovládacích prvků.
Ovládací prvky posuvníku umožňují uživateli posouvat obsah v okně nebo kontejneru položek. Ovládací prvek se skládá ze sady tlačítek a ovládacího prvku palce.
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 ScrollBar. 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 model UI Automation stromu, který se týká ovládacích prvků posuvníku, 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 |
|---|---|
| ScrollBar - Tlačítko (2 nebo 4) - Palec (0 nebo1) |
Nevztahuje se. Ovládací prvek posuvníku neobsahuje obsah. |
Ovládací prvek posuvníku má vždy tři až pět podřízených položek. Vzhledem k tomu, že podstrom obsahuje více než jeden ovládací prvek tlačítka, je nutné nastavit konkrétní AutomationIdProperty hodnotu pro každou položku, aby byly zjistitelné pro testovací automatizační nástroje.
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 posuvníku. Všimněte si, že ovládací prvek posuvníku nikdy nemá obsah; jeho funkce je zpřístupněna prostřednictvím vzoru ovládacích prvků posuvníku, který je podporován při posouvání kontejneru.
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. |
| IsKeyboardFocusableProperty | Viz poznámky. | Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat. |
| NameProperty | Null |
Ovládací prvek posuvníku neobsahuje prvky obsahu a NameProperty není nutné ho nastavit. |
| ClickablePointProperty | Ne číslo. | Ovládací prvek posuvníku nemá klikatelné body. |
| LabeledByProperty | Null |
Posuvníky nemají popisky. |
| ControlTypeProperty | ScrollBar | Tato hodnota je stejná pro všechny architektury. Posuvníky, které fungují jako posuvníky, musí používat typ ovládacího prvku Posuvník. |
| LocalizedControlTypeProperty | "posuvník" | Lokalizovaný řetězec odpovídající typu ovládacího prvku Button. |
| IsContentElementProperty | False | Ovládací prvek posuvníku není nikdy prvkem obsahu. Pokud je posuvník samostatný ovládací prvek, musí splňovat typ ovládacího prvku Posuvník a vrátit ControlType.Slider vlastnost ControlType . |
| IsControlElementProperty | True | Posuvník musí být vždy ovládací prvek. |
| OrientationProperty | True | Ovládací prvek posuvníku musí vždy vystavit jeho vodorovnou nebo svislou orientaci. |
Požadované vzory ovládacích prvků model UI Automation
V následující tabulce jsou uvedeny vzory ovládacích prvků model UI Automation vyžadované ovládacími prvky posuvníku. Další informace o vzorech ovládacích prvků najdete v tématu model UI Automation Přehled vzorů ovládacích prvků. Všimněte si, že pokud se posuvník používá pouze jako ovládací prvek pro manipulaci s myší, nepodporuje vzory ovládacích prvků. Pokud se používá jako ovládací prvek posuvníku v aplikaci, musí být uveden typ ovládacího prvku Posuvník.
| Vzor ovládacího prvku | Technická podpora | Notes |
|---|---|---|
| IScrollProvider | Nikdy | Vzor ovládacího prvku Scroll se nikdy přímo nepodporuje na posuvníku. |
| IRangeValueProvider | Závisí | Tato funkce se vyžaduje, aby byla podporována pouze v případě, že se v kontejneru s posuvníkem nepodporuje vzor ovládacího prvku Scroll. |
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 posuvníku. Další informace o událostech najdete v tématu model UI Automation Přehled událostí.
| událost model UI Automation | Podpora/hodnota | 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 |
| HorizontallyScrollableProperty událost změněná vlastností. | Nikdy | Nic |
| HorizontalScrollPercentProperty událost změněná vlastností. | Nikdy | Nic |
| HorizontalViewSizeProperty událost změněná vlastností. | Nikdy | Nic |
| VerticalScrollPercentProperty událost změněná vlastností. | Nikdy | Nic |
| VerticallyScrollableProperty událost změněná vlastností. | Nikdy | Nic |
| VerticalViewSizeProperty událost změněná vlastností. | Nikdy | Nic |
| ValueProperty událost změněná vlastností. | Závisí | Nic |
| AutomationFocusChangedEvent | Požaduje se | Nic |
| StructureChangedEvent | Požaduje se | Nic |