Implementace mřížkového ovládacího vzoru automatizace 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 automatizace uživatelského rozhraní definované v oboru názvů System.Windows.Automation. Nejnovější informace o automatizaci uživatelského rozhraní najdete v tématu rozhraní API služby Windows Automation: Automatizace uživatelského rozhraní.

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 řízení se používá k podpoře ovládacích prvků, které fungují jako kontejnery pro kolekci dětských prvků. Podřízené položky tohoto prvku musí implementovat IGridItemProvider a uspořádat se do dvourozměrného logického souřadnicového systému, který lze procházet podle řádků a sloupců. Příklady ovládacích prvků, které implementují tento vzor ovládacího prvku, naleznete v tématu mapování vzorů ovládacích prvků pro klienty automatizace uživatelského rozhraní.

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ženy na nulovém základu, přičemž levá horní buňka (nebo pravá horní buňka v závislosti na uživatelském prostředí) má souřadnice (0, 0).

• Pokud je buňka prázdná, musí být prvek automatizace uživatelského rozhraní vrácen, aby ContainingGrid podporoval vlastnost této buňky. To je možné, když je rozložení podřízených prvků v mřížce podobné zubatému poli (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 nepodstatný.

• Skryté řádky a sloupce se mohou, v závislosti na implementaci zprostředkovatele, načíst do stromu uživatelské automatizace, a proto se projeví ve vlastnostech RowCount a ColumnCount. 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é.

• Pomocí AutomationFocusChangedEventHandler sledujte 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	Poznámky
RowCount	Vlastnictví	Žádné
ColumnCount	Vlastnictví	Žádné
GetItem	Metoda	Žádné

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ž RowCount nebo souřadnice sloupce je větší než ColumnCount.
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ů automatizace uživatelského rozhraní
• Podpora vzorů ovládacích prvků v poskytovateli automatizace uživatelského rozhraní
• Vzory ovládacích prvků automatizace uživatelského rozhraní pro klienty
• Implementace vzoru ovládacího prvku GridItem pro automatizaci uživatelského rozhraní
• Přehled stromu automatizace uživatelského rozhraní
• Použití ukládání do mezipaměti v automatizaci uživatelského rozhraní