Het transformatiebeheerpatroon van de ui-automatisering implementeren
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.
In dit onderwerp worden richtlijnen en conventies geïntroduceerd voor het implementeren ITransformProvider, inclusief 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 Beheerpatroontoewijzing voor UI Automation-clients voor 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 | Type lid | Opmerkingen |
|---|---|---|
| CanMove | Eigenschappen | Geen |
| CanResize | Eigenschappen | Geen |
| CanRotate | Eigenschappen | Geen |
| Move | Wijze | Geen |
| Resize | Wijze | Geen |
| Rotate | Wijze | Geen |
Dit besturingspatroon heeft geen gekoppelde gebeurtenissen.
Uitzonderingen
Providers moeten de volgende uitzonderingen genereren.
| Type uitzondering | Conditie |
|---|---|
| InvalidOperationException | Move - Als het CanMoveProperty onwaar is. |
| InvalidOperationException | Resize - Als het CanResizeProperty onwaar is. |
| InvalidOperationException | Rotate - Als het CanRotateProperty onwaar is. |