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

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 Kalendář. 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 kalendáře umožňují uživateli snadno určit datum a vybrat jiná data.

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 Kalendář. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky kalendáře, 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ů kalendáře, 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
Kalendář DataGrid Záhlaví (0 nebo 1) HeaderItem (0 nebo 7; množství závisí na tom, kolik dní se zobrazuje ve sloupcích) ListItem (množství závisí na tom, kolik dní se zobrazí) Tlačítko (0 nebo 2; pro stránkovací zobrazení kalendáře)	Kalendář – ListItem (množství závisí na tom, kolik dní se zobrazí)

Ovládací prvky kalendáře mohou být reprezentovány v mnoha různých formách v uživatelském rozhraní. Jediné zaručené ovládací prvky, které mají být v zobrazení ovládacích prvků stromu Automatizace uživatelského rozhraní, jsou datová mřížka, záhlaví, položka záhlaví a ovládací prvky položky seznamu.

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 kalendáře. 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.
ControlTypeProperty	Kalendář	Tato hodnota je stejná pro všechny architektury uživatelského rozhraní.
IsContentElementProperty	Pravdivé	Ovládací prvek kalendáře je vždy součástí zobrazení obsahu stromu Automatizace uživatelského rozhraní.
IsControlElementProperty	Pravdivé	Ovládací prvek kalendáře je vždy součástí zobrazení ovládacího prvku stromu Automatizace uživatelského rozhraní.
IsKeyboardFocusableProperty	Viz poznámky.	Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat.
LabeledByProperty	Viz poznámky.	Popisek kontroly dokumentu Obvykle se používá název dokumentu.
LocalizedControlTypeProperty	"kalendář"	Lokalizovaný řetězec odpovídající typu ovládacího prvku Kalendář
NameProperty	Viz poznámky.	Ovládací prvek kalendáře obvykle získá jeho název od data aktuálního dne.

Požadované vzory 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é musí podporovat všechny ovládací prvky kalendáře. 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	Poznámky
IGridProvider	Ano	Ovládací prvek kalendář vždy podporuje vzor mřížky, protože dny v měsíci jsou položky, které se dají prostorově procházet.
IScrollProvider	Závisí	Většina ovládacích prvků kalendáře podporuje překlopení zobrazení podle stránky. Pro podporu stránkovací navigace se doporučuje rolovací vzor.
ISelectionProvider	Závisí	Většina ovládacích prvků kalendáře uchovává jako výběr dílčího prvku konkrétní den, měsíc nebo rok. Některé kalendáře jsou vícenásobně vybratelné a jiné jen s jedním výběrem.
ITableProvider	Ano	Ovládací prvek kalendáře vždy obsahuje záhlaví pro dny v týdnu uvnitř svého podstromu, takže vzor tabulky musí být podporován.
IValueProvider	Ne	Vzor ovládacího prvku Hodnota není nutný pro ovládací prvky kalendáře, protože hodnotu nelze nastavit přímo na ovládacím prvku. Pokud je k ovládacímu prvku přidruženo konkrétní datum, měly by být informace poskytnuty vzorem ovládacího prvku Výběr.

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 kalendáře. Další informace o událostech naleznete v tématu Přehled událostí automatizace uživatelského rozhraní.

Událost automatizace uživatelského rozhraní	Podpora	Poznámky
AutomationFocusChangedEvent	Povinné	Žádné
BoundingRectangleProperty událost změny vlastnosti.	Povinné	Žádné
IsEnabledProperty událost změny vlastnosti.	Povinné	Žádné
IsOffscreenProperty událost změny vlastnosti.	Povinné	Žádné
LayoutInvalidatedEvent	Povinné	Žádné
StructureChangedEvent	Povinné	Žádné
CurrentViewProperty událost změny vlastnosti.	Závisí	Žádné
HorizontallyScrollableProperty událost změny vlastnosti.	Závisí	Pokud ovládací prvek podporuje vzor ovládacího prvku Scroll, musí tuto událost podporovat.
HorizontalScrollPercentProperty událost změny vlastnosti.	Závisí	Pokud ovládací prvek podporuje vzor ovládacího prvku Scroll, musí tuto událost podporovat.
HorizontalViewSizeProperty událost změny vlastnosti.	Závisí	Pokud ovládací prvek podporuje vzor ovládacího prvku Scroll, musí tuto událost podporovat.
VerticalScrollPercentProperty událost změny vlastnosti.	Závisí	Pokud ovládací prvek podporuje vzor ovládacího prvku Scroll, musí tuto událost podporovat.
VerticallyScrollableProperty událost změny vlastnosti.	Závisí	Pokud ovládací prvek podporuje vzor ovládacího prvku Scroll, musí tuto událost podporovat.
VerticalViewSizeProperty událost změny vlastnosti.	Závisí	Pokud ovládací prvek podporuje vzor ovládacího prvku Scroll, musí tuto událost podporovat.
InvalidatedEvent	Povinné	Žádné

Viz také

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