Podpora automatizace uživatelského rozhraní pro typ ovládacího prvku SplitButton
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 SplitButton. 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í prvek rozdělit tlačítko umožňuje provést akci na ovládacím prvku a rozbalit ovládací prvek, aby se zobrazil seznam dalších možných akcí, které lze provést.
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 SplitButton. Požadavky na model UI Automation platí pro všechny ovládací prvky tlačítka rozdělení, 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ů rozdělených 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 |
|---|---|
SplitButton
|
SplitButton - MenuItem (1 až mnoho) |
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 tlačítka rozdělení. 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. |
| IsKeyboardFocusableProperty | Viz poznámky. | Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat. |
| NameProperty | "Zpět" | Název ovládacího prvku split button se zobrazí na tlačítku. |
| LabeledByProperty | Null | Ovládací prvky tlačítka Rozdělení nemají statický textový popisek. |
| ControlTypeProperty | SplitButton | Tato hodnota je stejná pro všechny architektury uživatelského rozhraní. |
| LocalizedControlTypeProperty | "split button" | Lokalizovaný řetězec odpovídající typu ovládacího prvku SplitButton. |
| HelpTextProperty | Viz poznámky. | Text nápovědy může znamenat výsledek aktivace tlačítka rozdělení, což je obvykle stejný typ informací zobrazených prostřednictvím popisu. |
| IsContentElementProperty | True | Ovládací prvek split button obsahuje informace pro koncového uživatele. |
| IsControlElementProperty | True | Ovládací prvek rozděleného tlačítka je viditelný pro koncového uživatele. |
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 rozděleného tlačítka. 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 | Požaduje se | Tlačítka rozdělení mají vždy přidruženou výchozí akci vyvolání. |
| IExpandCollapseProvider | Požaduje se | Tlačítka rozdělení mají vždy možnost rozbalit seznam možností. |
Požadované události model UI Automation
Následující tabulka uvádí model UI Automation události, které musí podporovat všechny ovládací prvky rozděleného tlačítka. Další informace o událostech najdete v tématu model UI Automation Přehled událostí.
| událost model UI Automation | Technická podpora | Notes |
|---|---|---|
| InvokedEvent | 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 |
| ExpandCollapseStateProperty událost změněná vlastností. | Požaduje se | Nic |
| AutomationFocusChangedEvent | Požaduje se | Nic |
| StructureChangedEvent | Požaduje se | Nic |
Příklad ovládacího prvku SplitButton
Následující obrázek znázorňuje typ ovládacího prvku SplitButton v ovládacím prvku datové mřížky.
Zobrazení ovládacích prvků a zobrazení obsahu model UI Automation stromu, které se týkají mřížky dat a ovládacích prvků tlačítka rozdělení, se zobrazí níže. Vzory ovládacích prvků pro každý prvek automatizace jsou zobrazeny v závorkách.
| strom model UI Automation – zobrazení ovládacího prvku | strom model UI Automation – zobrazení obsahu |
|---|---|
|
|