Sdílet prostřednictvím


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 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 ScrollBar. 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 . Podmínky zahrnují specifické pokyny pro strukturu stromu automatizace uživatelského rozhraní, hodnoty vlastností automatizace uživatelského rozhraní 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 stromovou strukturu automatizace uživatelského rozhraní, vlastnosti, vzory ovládacích prvků a události pro typ ovládacího prvku ScrollBar. 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ů posuvníku, 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
Posuvník

- Tlačítko (2 nebo 4)
- Palec (0 nebo1)
Nelze použít. 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 tlačítkových ovládacích prvků, je nutné nastavit hodnotu AutomationIdProperty pro každou položku, aby je bylo možné zjistit pro testovací automatizační nástroje.

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 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 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.
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 Není číslo. Ovládací prvek posuvníku nemá klikatelné body.
LabeledByProperty Null Posuvníky nemají popisky.
ControlTypeProperty Posuvník 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 Nepravda Ovládací prvek posuvníku není nikdy prvkem obsahu. Pokud je posuvník samostatným ovládacím prvkem, musí splňovat typ ovládacího prvku Posuvník a vrátit ControlType.Slider pro vlastnost ControlType.
IsControlElementProperty Pravdivé Posuvník musí být vždy ovládací prvek.
OrientationProperty Pravdivé Ovládací prvek posuvníku musí vždy vystavit jeho vodorovnou nebo svislou orientaci.

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

V následující tabulce jsou uvedeny vzory ovládacích prvků automatizace uživatelského rozhraní, které je nutné podporovat ovládacími prvky posuvníku. Další informace o vzorech ovládacích prvků najdete v tématu přehled vzorů ovládacích prvků automatizace uživatelského rozhraní. 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í mít typ ovládacího prvku Posuvník.

Vzor ovládacího prvku Podpora Poznámky
IScrollProvider Nikdy Vzor ovládání prvku Scroll není nikdy přímo podporován 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 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 posuvníku. 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/hodnota 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é
HorizontallyScrollableProperty událost změny vlastnosti. Nikdy Žádné
HorizontalScrollPercentProperty událost změny vlastnosti. Nikdy Žádné
HorizontalViewSizeProperty událost změny vlastnosti. Nikdy Žádné
VerticalScrollPercentProperty událost změny vlastnosti. Nikdy Žádné
VerticallyScrollableProperty událost změny vlastnosti. Nikdy Žádné
VerticalViewSizeProperty událost změny vlastnosti. Nikdy Žádné
ValueProperty událost změny vlastnosti. Závisí Žádné
AutomationFocusChangedEvent Povinné Žádné
StructureChangedEvent Povinné Žádné

Viz také

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