Delen via

UI Automation-besturingspatronen voor clients

  • Artikel

Notitie

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 Automation voor de meest recente informatie over UI Automation.

Dit overzicht introduceert besturingspatronen voor UI Automation-clients. Het bevat informatie over hoe een UI Automation-client besturingspatronen kan gebruiken voor toegang tot informatie over de gebruikersinterface (UI).

Besturingspatronen bieden een manier om de functionaliteit van een besturingselement te categoriseren en beschikbaar te maken, onafhankelijk van het besturingselementtype of het uiterlijk van het besturingselement. UI Automation-clients kunnen een AutomationElement onderzoek uitvoeren om te bepalen welke besturingspatronen worden ondersteund en om zeker te zijn van het gedrag van het besturingselement.

Zie Overzicht van ui Automation-besturingspatronen voor een volledige lijst met besturingspatronen.

Controlepatronen krijgen

Clients halen een besturingspatroon op uit een AutomationElement door aan te roepen AutomationElement.GetCachedPattern of AutomationElement.GetCurrentPattern.

Clients kunnen de GetSupportedPatterns methode of een afzonderlijke IsPatternAvailable eigenschap (bijvoorbeeld IsTextPatternAvailableProperty) gebruiken om te bepalen of een patroon of groep patronen wordt ondersteund op de AutomationElement. Het is echter efficiënter om het controlepatroon op te halen en te testen op een null verwijzing dan om de ondersteunde eigenschappen te controleren en het besturingspatroon op te halen, omdat dit resulteert in minder aanroepen voor meerdere processen.

In het volgende voorbeeld ziet u hoe u een TextPattern besturingspatroon kunt ophalen uit een 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;
}

Eigenschappen ophalen voor besturingspatronen

Clients kunnen de eigenschapswaarden voor besturingspatronen ophalen door het aanroepen AutomationElement.GetCachedPropertyValue of AutomationElement.GetCurrentPropertyValue en casten van het object dat is geretourneerd naar een geschikt type. Zie Eigenschappen van UI Automation voor clients voor meer informatie over eigenschappen van UI Automation.

Naast de GetPropertyValue methoden kunnen eigenschapswaarden worden opgehaald via de CLR-toegangsors (Common Language Runtime) voor toegang tot de eigenschappen van UI Automation op een patroon.

Besturingselementen met variabele patronen

Sommige besturingstypen ondersteunen verschillende patronen, afhankelijk van hun status of de manier waarop het besturingselement wordt gebruikt. Voorbeelden van besturingselementen met variabele patronen zijn lijstweergaven (miniaturen, tegels, pictogrammen, lijst, details), Microsoft Excel-grafieken (cirkel-, lijn-, staaf-, celwaarde met een formule), het documentgebied van Microsoft Word (normaal, webindeling, overzicht, afdrukweergave, afdrukvoorbeeld) en Microsoft Windows Mediaspeler skins.

Besturingselementen die aangepaste besturingstypen implementeren, kunnen elke set besturingspatronen hebben die nodig zijn om hun functionaliteit weer te geven.

Zie ook