Delen via

UI Automation-besturingspatronen voor clients

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.

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 AutomationElement.GetCachedPattern of AutomationElement.GetCurrentPattern aan te roepen.

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

Klanten kunnen de eigenschapswaarden voor besturingspatronen ophalen door ofwel AutomationElement.GetCachedPropertyValue of AutomationElement.GetCurrentPropertyValue aan te roepen en door het geretourneerde object naar een geschikt type te casten. Zie UI Automation-eigenschappen voor cliënten voor meer informatie over UI Automation-eigenschappen.

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 bedieningselementen die variabele patronen kunnen hebben, zijn lijstweergaven (miniaturen, tegels, pictogrammen, lijst, details), Microsoft Excel-grafieken (cirkel-, lijn-, staaf-, celwaarde met een formule), het documentvenster van Microsoft Word (normaal, webindeling, overzicht, afdrukweergave, afdrukvoorbeeld) en skins van Microsoft Windows Media Player.

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

Zie ook

  • Last updated on