Delen via

Het UI Automation Vensterbeheerpatroon 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 IWindowProvider, inclusief informatie over WindowPattern eigenschappen, methoden en gebeurtenissen. Koppelingen naar aanvullende verwijzingen worden aan het einde van het onderwerp weergegeven.

Het WindowPattern besturingspatroon wordt gebruikt om besturingselementen te ondersteunen die fundamentele venstergebaseerde functionaliteit bieden binnen een traditionele grafische gebruikersinterface (GUI). Voorbeelden van besturingselementen die dit besturingspatroon moeten implementeren, zijn toepassingsvensters op het hoogste niveau, onderliggende vensters met meerdere documenten (MDI), besturingselementen voor splitsvensters, modale dialoogvensters en helpvensters voor ballonnen.

Implementatierichtlijnen en conventies

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

  • Ter ondersteuning van de mogelijkheid om zowel de venstergrootte als de schermpositie te wijzigen met behulp van UI Automation, moet naast een besturingselement ook een besturingselement worden geïmplementeerd ITransformProviderIWindowProvider.

  • Besturingselementen die titelbalken en titelbalkelementen bevatten waarmee het besturingselement kan worden verplaatst, vergroot of verkleind, gemaximaliseerd, geminimaliseerd of gesloten, moeten doorgaans IWindowProvider implementeren.

  • Besturingselementen zoals tooltip pop-ups en vervolgkeuzemenu's of keuzelijsten worden meestal niet geïmplementeerd IWindowProvider.

  • Ballonhulpvensters worden onderscheiden van eenvoudige hulpmeldingen door de aanwezigheid van een vensterachtige Sluiten-knop.

  • De modus Volledig scherm wordt niet ondersteund door IWindowProvider omdat deze functiespecifiek is voor een toepassing en niet typisch venstergedrag is.

Vereiste leden voor IWindowProvider

De volgende eigenschappen, methoden en gebeurtenissen zijn vereist voor de IWindowProvider-interface.

Vereist onderdeel Ledentype Opmerkingen
InteractionState Vastgoed Geen
IsModal Vastgoed Geen
IsTopmost Vastgoed Geen
Maximizable Vastgoed Geen
Minimizable Vastgoed Geen
VisualState Vastgoed Geen
Close Methode Geen
SetVisualState Methode Geen
WaitForInputIdle Methode Geen
WindowClosedEvent Gebeurtenis Geen
WindowOpenedEvent Gebeurtenis Geen
WindowInteractionState Gebeurtenis Is niet gegarandeerd te zijn ReadyForUserInteraction

Uitzonderingen

Providers moeten de volgende uitzonderingen genereren.

Uitzonderingstype Conditie
InvalidOperationException SetVisualState

- Wanneer een besturingselement geen ondersteuning biedt voor een aangevraagd gedrag.
ArgumentOutOfRangeException WaitForInputIdle

- Wanneer de parameter geen geldig getal is.

Zie ook

  • Last updated on