Podpora automatizace uživatelského rozhraní pro typ ovládacího prvku tabulka
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 Tabulka. 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í prvky tabulky obsahují řádky a sloupce textu a volitelně záhlaví řádků a záhlaví sloupců.
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 Tabulka. Požadavky na model UI Automation platí pro všechny ovládací prvky tabulky, 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ů tabulky, 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 |
|---|---|
| Table - Záhlaví (0 nebo 1) - Text (0 nebo 1) - Různé ovládací prvky (0 nebo více) |
Table - Text (0 nebo více) - Různé ovládací prvky (0 nebo více) |
Pokud má ovládací prvek tabulky záhlaví řádků nebo sloupců, musí být vystavený v zobrazení ovládacího prvku ve stromu model UI Automation. Zobrazení obsahu nemusí tyto informace zveřejnit, protože k němu lze přistupovat pomocí tablePattern.
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 Tabulky. 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 | Viz poznámky. | Ovládací prvek tabulky obvykle získá jeho název ze statického textového popisku. Pokud neexistuje žádný statický textový popisek, musíte přiřadit vlastnost Name, která musí být vždy k dispozici k vysvětlení účelu tabulky. |
| LabeledByProperty | Viz poznámky. | Pokud je popisek statického textu, měla by tato vlastnost zveřejnit odkaz na prvek automatizace ovládacího prvku. |
| ControlTypeProperty | Table | Tato hodnota je stejná pro všechny architektury uživatelského rozhraní. |
| LocalizedControlTypeProperty | "table" | Lokalizovaný řetězec odpovídající typu ovládacího prvku Table. |
| HelpTextProperty | Viz poznámky. | Další podrobnosti o účelu tabulky by měly být zpřístupněny prostřednictvím této vlastnosti, pokud není dostatečně vysvětlena přístupem k NameProperty. |
| IsContentElementProperty | True | Ovládací prvek tabulky musí být vždy obsahem. |
| IsControlElementProperty | True | Ovládací prvek tabulky musí být vždy ovládací prvek. |
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é jsou potřeba k podpoře ovládacích prvků tabulky. 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 |
|---|---|---|
| IGridProvider | Ano | Ovládací prvek tabulka vždy podporuje tento vzor ovládacího prvku, protože položky, které obsahuje, mají data, která jsou prezentována v mřížce. |
| IGridItemProvider | Ano (povinné u podřízených objektů) | Vnitřní objekty tabulky by měly podporovat vzory ovládacích prvků GridItem i TableItem. Samotná tabulka nemusí podporovat vzory ovládacích prvků GridItem ani TableItem, pokud není tabulka součástí jiné tabulky. |
| ITableProvider | Ano | Ovládací prvek tabulka má vždy možnost mít záhlaví přidružená k obsahu. |
| ITableItemProvider | Ano (povinné u podřízených objektů) | Vnitřní objekty tabulky by měly podporovat vzory ovládacích prvků GridItem i TableItem. Samotná tabulka nemusí podporovat vzory ovládacích prvků GridItem ani TableItem, pokud není tabulka součástí jiné tabulky. |
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 tabulky. Další informace o událostech najdete v tématu model UI Automation Přehled událostí.
| událost model UI Automation | Technická podpora | Notes |
|---|---|---|
| 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 |
| AutomationFocusChangedEvent | Požaduje se | Nic |
| StructureChangedEvent | Požaduje se | Nic |