Přehled vlastností automatizace uživatelského rozhraní
Zprostředkovatelé automatizace uživatelského rozhraní Microsoftu zpřístupňují vlastnosti prvků automatizace uživatelského rozhraní. Vlastnosti umožňují klientským aplikacím načítat informace o ovládacích prvcích.
Automatizace uživatelského rozhraní zveřejňuje dva různé druhy vlastností: vlastnosti elementu automatizacea vlastnosti vzoru ovládacího prvku. Vlastnosti elementu automation se skládají z společné sady vlastností, jako je Name, AcceleratorKey a ClassName, které jsou vystaveny všemi prvky automatizace uživatelského rozhraní bez ohledu na typ ovládacího prvku. Většina vlastností elementu automatizace je statické hodnoty.
Vlastnosti ovládacího vzoru jsou ty, které jsou poskytovány ovládacím prvkem podporujícím daný ovládací vzor. Každý vzor ovládacího prvku má odpovídající sadu vlastností vzoru ovládacího prvku, které musí ovládací prvek vystavit. Například ovládací prvek, který podporuje vzor ovládání Grid, zveřejňuje vlastnosti ColumnCount a RowCount. Většina vlastností vzorů ovládacích prvků jsou dynamické hodnoty.
Toto téma obsahuje následující části.
- identifikátory vlastností
- hodnoty vlastností
- Vlastnosti a události
- související témata
Identifikátory vlastností
Každá vlastnost je identifikována PROPERTYID číselnou hodnotou označovanou jako identifikátor vlastnosti (ID). Zprostředkovatelé a klienti používají číselná ID při voláních metod, jako jsou IRawElementProviderAdviseEvents::AdviseEventAdded a IUIAutomationElement::GetCachedPropertyValue, aby identifikovali požadavky na vlastnosti. Podrobný popis každého identifikátoru vlastnosti automatizace uživatelského rozhraní, včetně datového typu a výchozí hodnoty každé vlastnosti, naleznete v tématu Identifikátory vlastností.
Hodnoty vlastností
Všechny vlastnosti jsou jen pro čtení, i když některé je možné změnit pomocí metod, které fungují na ovládacím prvku, například IDockProvider::SetDockPosition (provider) nebo IUIAutomationDockPattern::SetDockPosition (klient).
Informace o načítání hodnot vlastností naleznete v tématu Načítání vlastností z prvků automatizace uživatelského rozhraní.
Vlastnosti a události
Úzce spojený s vlastnostmi v UI Automation je koncept událostí změny vlastností . U dynamických vlastností klientská aplikace potřebuje způsob, jak zjistit, že se změnila hodnota vlastnosti, aby mohl aktualizovat mezipaměť informací nebo reagovat na nové informace jiným způsobem. Klienti se mohou zaregistrovat k naslouchání událostem změn vlastností u jakékoli vlastnosti.
Zprostředkovatelé vyvolávají události, když se něco v uživatelském rozhraní změní. Pokud je například zaškrtnuto nebo odkšrtnuto políčko, je událost změny vlastnosti vyvolána implementací zprostředkovatele vzoru ovládacího prvku Přepnout. 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í zprostředkovatelé proxy pro seznamová pole nevyvolají událost změny vlastnosti, když se změní vlastnost výběr. V tomto případě musí aplikace naslouchat události vyvolané při změně výběru (UIA_SelectionItem_ElementSelectedEventId).
Klienti naslouchají událostem přihlášením k odběru, jak je popsáno v tématu Přihlášení k odběru událostí automatizace uživatelského rozhraní. U událostí změny vlastností musí klienti implementovat IUIAutomationPropertyChangedEventHandler a předat toto rozhraní do IUIAutomation::AddPropertyChangedEventHandler nebo IUIAutomation::AddPropertyChangedEventHandlerNativeArray.
Související témata
-
referenční
-
koncepční
-
Přehled vzorů ovládacích prvků automatizace uživatelského rozhraní
-
Přehled typů ovládacích prvků automatizace uživatelského rozhraní