Implementace vzoru ovládacích prvků mřížka pro automatizaci uživatelského rozhraní
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 představuje pokyny a konvence pro implementaci IGridProvider, včetně informací o vlastnostech, metodách a událostech. Odkazy na další odkazy jsou uvedeny na konci přehledu.
Vzor GridPattern ovládacích prvků se používá k podpoře ovládacích prvků, které fungují jako kontejnery pro kolekci podřízených prvků. Podřízené položky tohoto prvku musí být implementovány IGridItemProvider a uspořádány do dvourozměrného logického souřadnicového systému, který lze projít podle řádku a sloupce. Příklady ovládacích prvků, které tento vzor ovládacích prvků implementují, naleznete v tématu Mapování vzorů ovládacích prvků pro model UI Automation Klienti.
Pokyny a konvence implementace
Při implementaci vzoru ovládacího prvku Mřížka si všimněte následujících pokynů a konvencí:
Souřadnice mřížky jsou založené na nule s levou horní (nebo pravou horní buňkou v závislosti na národním prostředí) se souřadnicemi (0, 0).
Pokud je buňka prázdná, musí být prvek model UI Automation vrácen, aby podporoval ContainingGrid vlastnost této buňky. To je možné, když je rozložení podřízených prvků v mřížce podobné nepravidelné matici (viz příklad níže).
Příklad ovládacího prvku mřížky s prázdnými souřadnicemi
Mřížka s jednou položkou se stále vyžaduje k implementaci IGridProvider , pokud je logicky považována za mřížku. Počet podřízených položek v mřížce je immaterial.
Skryté řádky a sloupce, v závislosti na implementaci zprostředkovatele, mohou být načteny do model UI Automation stromu, a proto se projeví ve vlastnostech a ColumnCount ve vlastnostechRowCount. Pokud skryté řádky a sloupce ještě nebyly načteny, neměly by se počítat.
IGridProvider neumožňuje aktivní manipulaci s mřížkou; ITransformProvider aby bylo možné tuto funkci povolit, musí být implementována.
StructureChangedEventHandler Umožňuje naslouchat změnám struktury nebo rozložení mřížky, jako jsou buňky přidané, odebrané nebo sloučené.
AutomationFocusChangedEventHandler Slouží ke sledování procházení položek nebo buněk mřížky.
Požadované členy pro IGridProvider
Pro implementaci rozhraní IGridProvider jsou vyžadovány následující vlastnosti a metody.
| Požadované členy | Typ | Notes |
|---|---|---|
| RowCount | Vlastnost | Nic |
| ColumnCount | Vlastnost | Nic |
| GetItem | metoda | Nic |
Tento vzor ovládacího prvku nemá žádné přidružené události.
Výjimky
Poskytovatelé musí vyvolat následující výjimky.
| Typ výjimky | Podmínka |
|---|---|
| ArgumentOutOfRangeException | GetItem - Pokud je požadovaná souřadnice řádku větší než souřadnice sloupce nebo je větší než RowCount souřadnice ColumnCountsloupce . |
| ArgumentOutOfRangeException | GetItem – Pokud je některý z požadovaných souřadnic řádků nebo sloupců menší než nula. |
Viz také
- Přehled vzorů ovládacích prvků pro automatizaci uživatelského rozhraní
- Podpora vzorů ovládacích prvků u zprostředkovatele automatizace uživatelského rozhraní
- Vzory ovládacích prvků automatizace uživatelského rozhraní pro klienty
- Implementace vzoru ovládacích prvků GridItem pro automatizaci uživatelského rozhraní
- Přehled stromu automatizace uživatelského rozhraní
- Použití mezipaměti při automatizaci uživatelského rozhraní