Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Opmerking
Deze documentatie is bedoeld voor .NET Framework-ontwikkelaars die de beheerde UI Automation-klassen willen gebruiken die zijn gedefinieerd in de System.Windows.Automation naamruimte. Zie Windows Automation-API: UI Automationvoor de meest recente informatie over UI Automation.
UI Automation-providers maken eigenschappen beschikbaar in Microsoft UI Automation-elementen. Met deze eigenschappen kunnen UI Automation-clienttoepassingen informatie vinden over onderdelen van de gebruikersinterface (UI), met name besturingselementen, waaronder zowel statische als dynamische gegevens.
In deze sectie vindt u een breed overzicht van de eigenschappen van Microsoft UI Automation. Meer specifieke informatie vindt u in de volgende onderwerpen:
Eigenschapsidentificatoren
Elke eigenschap wordt geïdentificeerd door een getal en een naam. De namen van eigenschappen worden alleen gebruikt voor foutopsporing en diagnose. Providers gebruiken de numerieke id's om binnenkomende eigenschapsaanvragen te identificeren. Clienttoepassingen gebruiken echter alleen AutomationProperty, dat het nummer en de naam inkapselt, om eigenschappen te identificeren die ze willen ophalen.
AutomationProperty objecten die bepaalde eigenschappen vertegenwoordigen, zijn beschikbaar als velden in verschillende klassen. Om veiligheidsredenen verkrijgen UI Automation-providers deze objecten uit een afzonderlijke set klassen die zijn opgenomen in Uiautomationtypes.dll.
De volgende tabel categoriseert eigenschappen op basis van de klassen die de AutomationPropertyid's bevatten.
| Soorten eigenschappen | Klanten krijgen identificatie van | Providers krijgen ID's van |
|---|---|---|
| Eigenschappen die gangbaar zijn voor alle elementen (zie de volgende tabellen) | AutomationElement | AutomationElementIdentifiers |
| Positie van een dokvenster | DockPattern | DockPatternIdentifiers |
| Status van een element dat kan worden opengevouwen en dichtgevouwen | ExpandCollapsePattern | ExpandCollapsePatternIdentifiers |
| Eigenschappen van een item in een raster | GridItemPattern | GridItemPatternIdentifiers |
| Eigenschappen van een raster | GridPattern | GridPatternIdentifiers |
| Huidige en ondersteunde weergave van een element met meerdere weergaven | MultipleViewPattern | MultipleViewPatternIdentifiers |
| Eigenschappen van een element dat wordt verplaatst over een bereik met waarden, zoals een schuifregelaar | RangeValuePattern | RangeValuePatternIdentifiers |
| Eigenschappen van een schuifvenster | ScrollPattern | ScrollPatternIdentifiers |
| Status en container van een item dat kan worden geselecteerd, zoals in een lijst | SelectionItemPattern | SelectionItemPatternIdentifiers |
| Eigenschappen van een besturingselement dat selectie-items bevat | SelectionPattern | SelectionPatternIdentifiers |
| Kolom- en rijkoppen van een item in een tabel | TableItemPattern | TableItemPatternIdentifiers |
| Kolom- en rijkoppen en oriëntatie van een tabel | TablePattern | TablePatternIdentifiers |
| Status van een wisselknop | TogglePattern | TogglePatternIdentifiers |
| Mogelijkheden van een element dat kan worden verplaatst, gedraaid of het formaat ervan kan worden gewijzigd | TransformPattern | TransformPatternIdentifiers |
| Waarde- en lees-/schrijfmogelijkheden van een element met een waarde | ValuePattern | ValuePatternIdentifiers |
| Mogelijkheden en status van een venster | WindowPattern | WindowPatternIdentifiers |
Eigenschappen per categorie
De volgende tabellen categoriseren de eigenschappen waarvan de IDs zich bevinden in AutomationElement en AutomationElementIdentifiers. Deze eigenschappen zijn gebruikelijk voor alle besturingselementen. Een paar zijn waarschijnlijk statisch gedurende de levensduur van de providertoepassing; de meeste dynamische eigenschappen zijn gekoppeld aan besturingspatronen.
De kolom Eigenschapstoegang bevat eventuele andere accessors voor elke eigenschap, naast GetCurrentPropertyValue en GetCachedPropertyValue. Zie voor meer informatie over het ophalen van eigenschappen in een clienttoepassing, UI Automation Properties for Clients.
Opmerking
Volg de koppeling in de kolom Eigenschapstoegang voor specifieke informatie over elke eigenschap.
Beeldkenmerken
| Eigenschaps-id | Toegang tot eigenschappen |
|---|---|
| BoundingRectangleProperty | BoundingRectangle |
| CultureProperty | n.v.t. |
| HelpTextProperty | HelpText |
| IsOffscreenProperty | IsOffscreen |
| OrientationProperty | Orientation |
Elementtype
| Eigenschaps-id | Toegang tot eigenschappen |
|---|---|
| ControlTypeProperty | ControlType |
| IsContentElementProperty | IsContentElement |
| IsControlElementProperty | IsControlElement |
| ItemTypeProperty | ItemType |
| LocalizedControlTypeProperty | LocalizedControlType |
Identificatie
Interactie
Ondersteuning voor patronen
Allerlei
| Eigenschaps-id | Toegang tot eigenschappen |
|---|---|
| IsRequiredForFormProperty | IsRequiredForForm |
| IsPasswordProperty | IsPassword |
| ItemStatusProperty | ItemStatus |
Lokalisatie
UI Automation-providers moeten de volgende eigenschappen in de taal van het besturingssysteem presenteren:
Eigenschappen en gebeurtenissen
Nauw verbonden met de eigenschappen in UI Automation is het concept van gebeurtenissen die door eigenschappen zijn gewijzigd. Voor dynamische eigenschappen heeft de clienttoepassing een manier nodig om te weten dat een eigenschapswaarde is gewijzigd, zodat deze de cache met gegevens kan bijwerken of op een andere manier kan reageren op de nieuwe informatie.
Providers genereren gebeurtenissen wanneer iets in de gebruikersinterface verandert. Als bijvoorbeeld een selectievakje is aangevinkt of uitgevinkt, wordt een gebeurtenis voor eigenschapswijziging gegenereerd door de implementatie van het Toggle-patroon van de provider. Providers kunnen selectief gebeurtenissen genereren, afhankelijk van of cliënten luisteren naar gebeurtenissen of naar specifieke gebeurtenissen.
Niet alle wijzigingen in eigenschappen veroorzaken gebeurtenissen; dat is volledig aan de implementatie van de UI Automation-provider voor het element. De standaardproxyproviders voor keuzelijsten veroorzaken bijvoorbeeld geen gebeurtenis wanneer de SelectionProperty verandert. In dit geval moet de toepassing in plaats daarvan luisteren naar een ElementSelectedEvent.
Clients luisteren naar gebeurtenissen door zich aan hen te abonneren. Abonneren op gebeurtenissen betekent het maken van gedelegeerde methoden die de gebeurtenissen kunnen verwerken en de methoden vervolgens doorgeven aan UI Automation, samen met de specifieke gebeurtenissen die in deze methoden worden behandeld. Voor gebeurtenissen die verband houden met veranderde eigenschappen, moeten klanten met name AutomationPropertyChangedEventHandler implementeren.
Zie ook
- Caching in UI Automation-clients
- Eigenschappen van UI Automation voor clients
- Server-Side implementatie van de UI Automation-provider
- Een UI Automation-element zoeken op basis van een eigenschapsvoorwaarde
- Eigenschappen teruggeven van UI Automation-provider
- Gebeurtenissen genereren vanuit een UI Automation-provider