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 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 Kalendář. 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 kalendáře umožňují uživateli snadno určit datum a vybrat jiná data.
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 Kalendář. Požadavky na model UI Automation platí pro všechny ovládací prvky kalendáře, 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ů kalendáře, 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 |
|---|---|
Calendar
|
Calendar – 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ů model UI Automation stromu, jsou mřížka dat, záhlaví, položka záhlaví a ovládací prvky položky seznamu.
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 kalendáře. 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. |
| ControlTypeProperty | Calendar | Tato hodnota je stejná pro všechny architektury uživatelského rozhraní. |
| IsContentElementProperty | True | Ovládací prvek kalendáře je vždy součástí zobrazení obsahu model UI Automation stromu. |
| IsControlElementProperty | True | Ovládací prvek kalendáře je vždy součástí zobrazení ovládacího prvku model UI Automation stromu. |
| 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 ovládacího prvku 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ů model UI Automation
V následující tabulce jsou uvedeny vzory ovládacích prvků model UI Automation, které musí podporovat všechny ovládací prvky kalendáře. 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 | Technická podpora | Notes |
|---|---|---|
| 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ánkování navigace se doporučuje vzor posouvání. |
| 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 má vždy záhlaví v podstromu pro dny v týdnu, takže vzor tabulky musí být podporovaný. |
| IValueProvider | No | 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 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 kalendáře. Další informace oudálostch model UI Automation ch
| událost model UI Automation | Technická podpora | Notes |
|---|---|---|
| AutomationFocusChangedEvent | Požaduje se | Nic |
| BoundingRectangleProperty událost změněná vlastností. | Požaduje se | Nic |
| IsEnabledProperty událost změněná vlastností. | Požaduje se | Nic |
| IsOffscreenProperty událost změněná vlastností. | Požaduje se | Nic |
| LayoutInvalidatedEvent | Požaduje se | Nic |
| StructureChangedEvent | Požaduje se | Nic |
| CurrentViewProperty událost změněná vlastností. | Závisí | Nic |
| HorizontallyScrollableProperty událost změněná vlastností. | Závisí | Pokud ovládací prvek podporuje vzor ovládacího prvku Scroll, musí tuto událost podporovat. |
| HorizontalScrollPercentProperty událost změněná vlastností. | Závisí | Pokud ovládací prvek podporuje vzor ovládacího prvku Scroll, musí tuto událost podporovat. |
| HorizontalViewSizeProperty událost změněná vlastností. | Závisí | Pokud ovládací prvek podporuje vzor ovládacího prvku Scroll, musí tuto událost podporovat. |
| VerticalScrollPercentProperty událost změněná vlastností. | Závisí | Pokud ovládací prvek podporuje vzor ovládacího prvku Scroll, musí tuto událost podporovat. |
| VerticallyScrollableProperty událost změněná vlastností. | Závisí | Pokud ovládací prvek podporuje vzor ovládacího prvku Scroll, musí tuto událost podporovat. |
| VerticalViewSizeProperty událost změněná vlastností. | Závisí | Pokud ovládací prvek podporuje vzor ovládacího prvku Scroll, musí tuto událost podporovat. |
| InvalidatedEvent | Požaduje se | Nic |