Podpora automatizace uživatelského rozhraní pro typ ovládacího prvku tlačítko
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 Tlačítko. 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.
Tlačítko je objekt, se kterým uživatel pracuje, aby provedl nějakou akci, například tlačítka OK a Zrušit v dialogovém okně. Ovládací prvek tlačítka je jednoduchý ovládací prvek pro zveřejnění, protože se mapuje na jeden příkaz, který si uživatel přeje dokončit.
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 Button. Požadavky na model UI Automation platí pro všechny ovládací prvky tlačítek, 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ů tlačítek, a popisuje, co může být obsaženo v jednotlivých zobrazeních. Další informace o stromu model UI Automation najdete v tématu model UI Automation Stromový přehled.
| Zobrazení ovládacího prvku | Zobrazení obsahu |
|---|---|
| Tlačítko - Obrázek (0 nebo více) - Text (0 nebo více) |
Tlačítko |
Požadované vlastnosti model UI Automation
V následující tabulce jsou uvedeny vlastnosti model UI Automation, jejichž hodnota nebo definice jsou zvláště relevantní pro ovládací prvky, které implementují typ ovládacího prvku Button (například ovládací prvky tlačítka). Další informace o model UI Automation vlastnosti naleznete v tématu model UI Automation Vlastnosti pro klienty.
| vlastnost model UI Automation | Hodnota | Notes |
|---|---|---|
| AcceleratorKeyProperty | Viz poznámky. | Ovládací prvek Button obvykle musí podporovat klávesu akcelerátoru, aby koncový uživatel mohl provést akci, kterou představuje rychle z klávesnice. |
| 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 | Tlačítko | Tato hodnota je stejná pro všechny architektury uživatelského rozhraní. |
| HelpTextProperty | Viz poznámky. | Text nápovědy může indikovat, jaký bude konečný výsledek aktivace tlačítka. Obvykle se jedná o stejný typ informací, které se zobrazují prostřednictvím popisu. |
| IsContentElementProperty | True | Ovládací prvek Button musí být vždy obsah. |
| IsControlElementProperty | True | Ovládací prvek Tlačítko musí být vždy ovládací prvek. |
| IsKeyboardFocusableProperty | Viz poznámky. | Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat. |
| LabeledByProperty | Null |
Ovládací prvky tlačítek jsou označené svým obsahem. |
| LocalizedControlTypeProperty | "button" | Lokalizovaný řetězec odpovídající typu ovládacího prvku Button. |
| NameProperty | Viz poznámky. | Název ovládacího prvku tlačítka je text, který se používá k označení. Při každém použití obrázku k označení tlačítka musí být pro vlastnost Název tlačítka zadán alternativní text. |
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é pro podporu všech ovládacích prvků tlačítek. Další informace o vzorech ovládacích prvků najdete v tématu model UI Automation Přehled vzorů ovládacích prvků.
| Vzor ovládacího prvku | Technická podpora | Notes |
|---|---|---|
| IInvokeProvider | Viz poznámky. | Všechna tlačítka by měla podporovat vzor ovládacího prvku Vyvolat nebo Přepnout vzor ovládacího prvku. Vyvolání se podporuje, když tlačítko provede příkaz na žádost uživatele. Tento příkaz se mapuje na jednu operaci, jako je vyjmutí, kopírování, vložení nebo odstranění. |
| IToggleProvider | Viz poznámky. | Všechna tlačítka by měla podporovat vzor ovládacího prvku Vyvolat nebo Přepnout vzor ovládacího prvku. Přepínač se podporuje, pokud je možné tlačítko cyklicky procházet řadou až tří stavů. Obvykle se to považuje za přepínač zapnuto/vypnuto pro konkrétní funkce. |
| IExpandCollapseProvider | Viz poznámky. | Pokud je tlačítko hostované jako podřízené tlačítko rozdělení, podřízené tlačítko může podporovat vzor ExpandCollapse místo vyvolání nebo přepínacího vzoru. Vzor ExpandCollapse lze použít k otevření nebo zavření nabídky nebo jiné dílčí struktury přidružené k prvku button. |
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 tlačítek. Další informace o událostech najdete v tématu model UI Automation Přehled událostí.
| událost model UI Automation | Technická podpora | Notes |
|---|---|---|
| AutomationFocusChangedEvent | Požaduje se | Nic |
| 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 |
| StructureChangedEvent | Požaduje se | Nic |
| InvokedEvent | Závisí | Pokud ovládací prvek podporuje vzor ovládacího prvku Invoke, musí tuto událost podporovat. |
| ToggleStateProperty událost změněná vlastností. | Závisí | Pokud ovládací prvek podporuje vzor přepínacího ovládacího prvku, musí tuto událost podporovat. |