Het transformatiebeheerpatroon van de ui-automatisering implementeren

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.

In dit onderwerp worden richtlijnen en conventies geïntroduceerd voor het implementeren van ITransformProvider, waaronder informatie over eigenschappen, methoden en gebeurtenissen. Koppelingen naar aanvullende verwijzingen worden aan het einde van het onderwerp weergegeven.

Het TransformPattern besturingspatroon wordt gebruikt ter ondersteuning van besturingselementen die kunnen worden verplaatst, aangepast of gedraaid binnen een tweedimensionale ruimte. Zie Toewijzing van besturingspatronen voor UI Automation-clientsvoor voorbeelden van besturingselementen die dit besturingspatroon implementeren.

Implementatierichtlijnen en conventies

Let bij het implementeren van het transformatiebeheerpatroon op de volgende richtlijnen en conventies:

• Ondersteuning voor dit besturingspatroon is niet beperkt tot objecten op het bureaublad. Dit besturingspatroon moet ook worden ondersteund door de onderliggende elementen van een containerobject als de onderliggende objecten vrij kunnen worden verplaatst, aangepast of gedraaid binnen de grenzen van de container.

• Een object kan niet worden verplaatst, aangepast of zodanig worden gedraaid dat de resulterende schermlocatie volledig buiten de coördinaten van de container zou liggen en daarom niet toegankelijk is voor het toetsenbord of de muis (bijvoorbeeld wanneer een venster op het hoogste niveau buiten het scherm wordt verplaatst of een onderliggend object buiten de grenzen van de viewport van de container wordt verplaatst). In deze gevallen wordt het object zo dicht mogelijk bij de aangevraagde schermcoördinaten geplaatst, waarbij de coördinaten boven of links worden overschreven om zich binnen de containergrenzen te bevinden.

• Als voor systemen met meerdere beeldschermen een object wordt verplaatst, aangepast of volledig buiten de gecombineerde coördinaten van het bureaubladscherm wordt gedraaid, wordt het object zo dicht mogelijk bij de aangevraagde coördinaten geplaatst op de primaire monitor.

• Alle parameters en eigenschapswaarden zijn absoluut en onafhankelijk van landinstellingen.

Vereiste leden voor ITransformProvider

De volgende eigenschappen en methoden zijn vereist voor de implementatie ITransformProvider.

Vereiste leden	Ledentype	Opmerkingen
CanMove	Vastgoed	Geen
CanResize	Vastgoed	Geen
CanRotate	Vastgoed	Geen
Move	Methode	Geen
Resize	Methode	Geen
Rotate	Methode	Geen

Dit besturingspatroon heeft geen gekoppelde gebeurtenissen.

Uitzonderingen

Providers moeten de volgende uitzonderingen genereren.

Uitzonderingstype	Conditie
InvalidOperationException	Move - Als het CanMoveProperty onwaar is.
InvalidOperationException	Resize - Als het CanResizeProperty onwaar is.
InvalidOperationException	Rotate - Als het CanRotateProperty onwaar is.

Zie ook

• Overzicht van UI-automatiseringsbesturingspatronen
• Ondersteuning van bedieningspatronen in een UI Automation Provider
• UI Automation-besturingspatronen voor clients
• Overzicht van de UI Automation Tree
• Caching gebruiken in de UI-automatisering van de gebruikersinterface