Sdílet prostřednictvím

Vzory ovládacích prvků automatizace uživatelského rozhraní pro klienty

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í.

Tento přehled představuje vzory ovládacích prvků pro klienty automatizace uživatelského rozhraní. Obsahuje informace o tom, jak může klient automatizace uživatelského rozhraní používat řídicí vzory pro přístup k informacím o uživatelském rozhraní.

Vzory ovládacích prvků poskytují způsob, jak kategorizovat a vystavit funkce ovládacího prvku nezávisle na typu ovládacího prvku nebo vzhledu ovládacího prvku. Klienti automatizace uživatelského rozhraní můžou prozkoumat, AutomationElement které vzory ovládacích prvků jsou podporovány, a mít jistotu o chování ovládacího prvku.

Úplný seznam vzorů ovládacích prvků najdete v tématu Přehled vzorů ovládacích prvků automatizace uživatelského rozhraní.

Získání vzorů ovládacích prvků

Klienti načítají řídicí vzor z AutomationElement zavoláním buď AutomationElement.GetCachedPattern nebo AutomationElement.GetCurrentPattern.

Klienti mohou použít metodu GetSupportedPatterns nebo jednotlivou IsPatternAvailable vlastnost (například IsTextPatternAvailableProperty) k určení, zda je v objektu AutomationElementpodporován vzor nebo skupina vzorů . Je však efektivnější se pokusit získat vzor ovládacího prvku a testovat null odkaz, než zkontrolovat podporované vlastnosti a načíst vzor ovládacího prvku, protože výsledkem je méně volání mezi procesy.

Následující příklad ukazuje, jak získat TextPattern řídicí vzor z AutomationElement.

// Specify the control type we're looking for, in this case 'Document'
PropertyCondition cond = new PropertyCondition(AutomationElement.ControlTypeProperty, ControlType.Document);

// target --> The root AutomationElement.
AutomationElement textProvider = target.FindFirst(TreeScope.Descendants, cond);

targetTextPattern = textProvider.GetCurrentPattern(TextPattern.Pattern) as TextPattern;

if (targetTextPattern == null)
{
    Console.WriteLine("Root element does not contain a descendant that supports TextPattern.");
    return;
}

Načítání vlastností vzorů ovládacích prvků

Klienti mohou načíst hodnoty vlastností u vzorů ovládacích prvků tím, že zavolají AutomationElement.GetCachedPropertyValue nebo AutomationElement.GetCurrentPropertyValue a přetypují vrácený objekt na odpovídající typ. Další informace o vlastnostech automatizace uživatelského rozhraní naleznete v tématu Vlastnosti automatizace uživatelského rozhraní pro klienty.

Kromě GetPropertyValue metod lze hodnoty vlastností načíst prostřednictvím přístupových objektů CLR (Common Language Runtime) pro přístup k vlastnostem automatizace uživatelského rozhraní ve vzoru.

Ovládací prvky s proměnnými vzory

Některé typy ovládacích prvků podporují různé vzory v závislosti na jejich stavu nebo způsobu, jakým se ovládací prvek používá. Příklady ovládacích prvků, které můžou mít proměnlivé vzory, jsou zobrazení seznamu (miniatury, dlaždice, ikony, seznam, podrobnosti), grafy Microsoft Excelu (výsečový, spojnicový, pruhový, hodnota buňky se vzorcem), oblast dokumentu Microsoft Wordu (normální, webové rozložení, osnova, rozložení při tisku, náhled tisku) a vzhledy aplikace Microsoft Windows Media Player.

Ovládací prvky implementované vlastní typy ovládacích prvků můžou mít libovolnou sadu vzorů ovládacích prvků, které jsou potřeba k reprezentaci jejich funkcí.

Viz také

  • Last updated on