Přehled vlastností 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 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.
model UI Automation zprostředkovatelé zpřístupňují vlastnosti prvků Microsoft model UI Automation. Tyto vlastnosti umožňují model UI Automation klientským aplikacím zjišťovat informace o částech uživatelského rozhraní(UI), zejména ovládacích prvků, včetně statických i dynamických dat.
V této části najdete obecný přehled vlastností microsoft model UI Automation. Konkrétnější informace najdete v následujících tématech:
Identifikátory vlastností
Každá vlastnost je identifikována číslem a názvem. Názvy vlastností se používají pouze pro ladění a diagnostiku. Zprostředkovatelé používají číselná ID k identifikaci příchozích požadavků na vlastnosti. Klientské aplikace však používají AutomationPropertypouze , který zapouzdřuje číslo a název, k identifikaci vlastností, které chtějí načíst.
AutomationProperty objekty představující konkrétní vlastnosti jsou k dispozici jako pole v různých třídách. Z bezpečnostních důvodů model UI Automation zprostředkovatele získávají tyto objekty ze samostatné sady tříd obsažených v Uiautomationtypes.dll.
Následující tabulka kategorizuje vlastnosti podle tříd, které obsahují AutomationPropertyID.
| Typy vlastností | Klienti získají ID z | Poskytovatelé získají ID z |
|---|---|---|
| Vlastnosti společné pro všechny prvky (viz následující tabulky) | AutomationElement | AutomationElementIdentifiers |
| Umístění ukotveného okna | DockPattern | DockPatternIdentifiers |
| Stav prvku, který může rozbalit a sbalit | ExpandCollapsePattern | ExpandCollapsePatternIdentifiers |
| Vlastnosti položky v mřížce | GridItemPattern | GridItemPatternIdentifiers |
| Vlastnosti mřížky | GridPattern | GridPatternIdentifiers |
| Aktuální a podporované zobrazení elementu s více zobrazeními | MultipleViewPattern | MultipleViewPatternIdentifiers |
| Vlastnosti elementu, který se pohybuje v rozsahu hodnot, například posuvník | RangeValuePattern | RangeValuePatternIdentifiers |
| Vlastnosti posuvného okna | ScrollPattern | ScrollPatternIdentifiers |
| Stav a kontejner položky, kterou lze vybrat, jako v seznamu | SelectionItemPattern | SelectionItemPatternIdentifiers |
| Vlastnosti ovládacího prvku, který obsahuje položky výběru | SelectionPattern | SelectionPatternIdentifiers |
| Záhlaví sloupců a řádků položky v tabulce | TableItemPattern | TableItemPatternIdentifiers |
| Záhlaví sloupců a řádků a orientace tabulky | TablePattern | TablePatternIdentifiers |
| Stav přepínacího ovládacího prvku | TogglePattern | TogglePatternIdentifiers |
| Možnosti prvku, který lze přesunout, otočit nebo změnit jeho velikost | TransformPattern | TransformPatternIdentifiers |
| Funkce hodnot a čtení a zápisu elementu, který má hodnotu | ValuePattern | ValuePatternIdentifiers |
| Možnosti a stav okna | WindowPattern | WindowPatternIdentifiers |
Vlastnosti podle kategorie
Následující tabulky kategorizují vlastnosti, jejichž ID jsou nalezena v AutomationElement a AutomationElementIdentifiers. Tyto vlastnosti jsou společné pro všechny ovládací prvky. Všechny kromě několika z nich budou pravděpodobně statické po celou dobu životnosti aplikace poskytovatele; většina dynamických vlastností je přidružena k vzorům ovládacích prvků.
Ve sloupci Přístup k vlastnostem jsou uvedeny všechny další přístupové objekty pro každou vlastnost, kromě GetCurrentPropertyValue a GetCachedPropertyValue. Další informace o získání vlastností v klientské aplikaci naleznete v tématu model UI Automation Vlastnosti pro klienty.
Poznámka:
Konkrétní informace o jednotlivých vlastnostech najdete na odkazu ve sloupci Přístup k vlastnostem.
Charakteristiky zobrazení
| Identifikátor vlastnosti | Přístup k vlastnostem |
|---|---|
| BoundingRectangleProperty | BoundingRectangle |
| CultureProperty | Není k dispozici |
| HelpTextProperty | HelpText |
| IsOffscreenProperty | IsOffscreen |
| OrientationProperty | Orientation |
Typ elementu
| Identifikátor vlastnosti | Přístup k vlastnostem |
|---|---|
| ControlTypeProperty | ControlType |
| IsContentElementProperty | IsContentElement |
| IsControlElementProperty | IsControlElement |
| ItemTypeProperty | ItemType |
| LocalizedControlTypeProperty | LocalizedControlType |
Identifikace
| Identifikátor vlastnosti | Přístup k vlastnostem |
|---|---|
| AutomationIdProperty | AutomationId |
| ClassNameProperty | ClassName |
| FrameworkIdProperty | FrameworkId |
| LabeledByProperty | LabeledBy |
| NameProperty | Name |
| ProcessIdProperty | ProcessId |
| RuntimeIdProperty | GetRuntimeId |
| NativeWindowHandleProperty | NativeWindowHandle |
Interakce
| Identifikátor vlastnosti | Přístup k vlastnostem |
|---|---|
| AcceleratorKeyProperty | AcceleratorKey |
| AccessKeyProperty | AccessKey |
| ClickablePointProperty | GetClickablePoint |
| HasKeyboardFocusProperty | HasKeyboardFocus |
| IsEnabledProperty | IsEnabled |
| IsKeyboardFocusableProperty | IsKeyboardFocusable |
Podpora vzorů
Různé
| Identifikátor vlastnosti | Přístup k vlastnostem |
|---|---|
| IsRequiredForFormProperty | IsRequiredForForm |
| IsPasswordProperty | IsPassword |
| ItemStatusProperty | ItemStatus |
Lokalizace
model UI Automation poskytovatelé by měli v jazyce operačního systému prezentovat následující vlastnosti:
Vlastnosti a události
Úzce svázané s vlastnostmi v model UI Automation je koncept událostí změněných vlastností. U dynamických vlastností klientská aplikace potřebuje způsob, jak zjistit, že se hodnota vlastnosti změnila, aby mohl aktualizovat mezipaměť informací nebo reagovat na nové informace jiným způsobem.
Zprostředkovatelé vyvolávají události, když se něco v uživatelském rozhraní změní. Pokud je například zaškrtnuto nebo nezaškrtnuto políčko, vyvolá se událost změněná vlastností implementací modelu Toggle zprostředkovatele. Zprostředkovatelé můžou selektivně vyvolat události v závislosti na tom, jestli klienti naslouchají událostem nebo naslouchají konkrétním událostem.
Ne všechny změny vlastností vyvolávají události; zcela až do implementace zprostředkovatele model UI Automation prvku. Například standardní zprostředkovatelé proxy serveru pro seznamy nevyvolají při změně událost SelectionProperty . V tomto případě musí aplikace naslouchat .ElementSelectedEvent
Klienti naslouchají událostem přihlášením k odběru. Přihlášení k odběru událostí znamená vytvoření metod delegáta, které mohou zpracovávat události, a následné předání metod model UI Automation spolu s konkrétními událostmi, které budou v těchto metodách zpracovávány. U událostí změněných vlastností musí klienti implementovat AutomationPropertyChangedEventHandler.
Viz také
- Práce s mezipamětí u klientů automatizace uživatelského rozhraní
- Vlastnosti automatizace uživatelského rozhraní pro klienty
- Implementace zprostředkovatele automatizace uživatelského rozhraní na straně serveru
- Hledání prvku automatizace uživatelského rozhraní na základě podmínky pro vlastnost
- Vrácení vlastností ze zprostředkovatele automatizace uživatelského rozhraní
- Vyvolávání událostí ze zprostředkovatele automatizace uživatelského rozhraní