Sdílet prostřednictvím

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

Poskytovatelé automatizace uživatelského rozhraní zpřístupňují vlastnosti prvků automatizace uživatelského rozhraní Microsoftu. Tyto vlastnosti umožňují klientským aplikacím automatizace uživatelského rozhraní zjišťovat informace o částech uživatelského rozhraní(UI), zejména ovládacích prvků, včetně statických i dynamických dat.

Tato část poskytuje obecný přehled vlastností automatizace uživatelského rozhraní Microsoftu. 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. Poskytovatelé používají číselná ID k identifikaci příchozích požadavků na atributy. Klientské aplikace však používají pouze AutomationProperty, 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ů získají poskytovatelé automatizace uživatelského rozhraní tyto objekty ze samostatné sady tříd, které jsou obsaženy 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ý lze sbalit a rozbalit 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
Hodnota a schopnost čtení a zápisu prvku, 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 Vlastnosti automatizace uživatelského rozhraní 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ů

Identifikátor vlastnosti Přístup k vlastnostem
IsDockPatternAvailableProperty GetSupportedPatterns
IsExpandCollapsePatternAvailableProperty GetSupportedPatterns
IsGridItemPatternAvailableProperty GetSupportedPatterns
IsGridPatternAvailableProperty GetSupportedPatterns
IsInvokePatternAvailableProperty GetSupportedPatterns
IsMultipleViewPatternAvailableProperty GetSupportedPatterns
IsRangeValuePatternAvailableProperty GetSupportedPatterns
IsScrollItemPatternAvailableProperty GetSupportedPatterns
IsScrollPatternAvailableProperty GetSupportedPatterns
IsSelectionItemPatternAvailableProperty GetSupportedPatterns
IsSelectionPatternAvailableProperty GetSupportedPatterns
IsTableItemPatternAvailableProperty GetSupportedPatterns
IsTablePatternAvailableProperty GetSupportedPatterns
IsTextPatternAvailableProperty GetSupportedPatterns
IsTogglePatternAvailableProperty GetSupportedPatterns
IsTransformPatternAvailableProperty GetSupportedPatterns
IsValuePatternAvailableProperty GetSupportedPatterns
IsWindowPatternAvailableProperty GetSupportedPatterns

Různé

Identifikátor vlastnosti Přístup k vlastnostem
IsRequiredForFormProperty IsRequiredForForm
IsPasswordProperty IsPassword
ItemStatusProperty ItemStatus

Lokalizace

Poskytovatelé automatizace uživatelského rozhraní 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 automatizaci uživatelského rozhraní je pojem událostí změny 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 políčko zaškrtnuto nebo nezaškrtnuto, je implementací modelu Toggle poskytovatele vyvolána událost změny vlastnosti. Poskytovatelé mohou selektivně vyvolávat události v závislosti na tom, zda klienti naslouchají událostem obecně nebo konkrétním událostem.

Ne všechny změny vlastností vyvolávají události; to je zcela až do implementace zprostředkovatele automatizace uživatelského rozhraní pro prvek. Například standardní poskytovatelé proxy pro seznamy nevyvolají událost, když se SelectionProperty změní. V tomto případě musí aplikace místo toho naslouchat na ElementSelectedEvent.

Klienti naslouchají událostem přihlášením se 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 automatizaci uživatelského rozhraní spolu s konkrétními událostmi, které budou v těchto metodách zpracovávány. U události změny vlastnosti musí klienti implementovat AutomationPropertyChangedEventHandler.

Viz také

  • Last updated on