Het Dock Control-patroon van gebruikersinterfaceautomatisering 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 voor implementatie IDockProvidergeïntroduceerd, inclusief informatie over eigenschappen. Koppelingen naar aanvullende verwijzingen worden aan het einde van het onderwerp weergegeven.

Het DockPattern besturingspatroon wordt gebruikt om de dockeigenschappen van een besturingselement in een dockingcontainer beschikbaar te maken. Een dockingcontainer is een besturingselement waarmee u onderliggende elementen horizontaal en verticaal kunt rangschikken ten opzichte van elkaar. Zie Toewijzing van besturingspatronen voor UI Automation-clientsvoor voorbeelden van besturingselementen die dit besturingspatroon implementeren.

Voorbeeld van docking vanuit Visual Studio waarbij het venster 'Klasseweergave' DockPosition.Right en het venster Foutlijst DockPosition.Bottom is

Implementatierichtlijnen en conventies

Let bij het implementeren van het Dock-besturingspatroon op de volgende richtlijnen en conventies:

• IDockProvider bevat geen eigenschappen van de dockingcontainer of eigenschappen van besturingselementen die zijn gekoppeld aan het huidige besturingselement in de dockingcontainer.

• Besturingselementen worden gedokt ten opzichte van elkaar op basis van hun huidige z-volgorde; hoe hoger hun z-orderplaatsing, hoe verder ze vanaf de opgegeven rand van de dockingcontainer worden geplaatst.

• Als het formaat van de dockingcontainer wordt gewijzigd, worden alle gedokte besturingselementen in de container gespoeld met dezelfde rand waarop ze oorspronkelijk zijn gedokt. De gedokte besturingselementen worden ook aangepast om ruimte binnen de container te vullen op basis van het dockinggedrag van de DockPositionbesturingselementen. Bijvoorbeeld, als Top is opgegeven, worden de linker- en rechterkant van de controle uitgebreid om alle beschikbare ruimte te vullen. Als Fill is opgegeven, worden alle vier de zijden van de besturingscontrole uitgebreid om alle beschikbare ruimte te vullen.

• Op een systeem met meerdere beeldschermen moeten besturingselementen links of rechts van de huidige monitor worden vastgedoken. Als dat niet mogelijk is, moeten ze aan de linkerkant van de meest linkse monitor of de rechterzijde van de meest rechtse monitor worden gedokt.

Vereiste leden voor IDockProvider

De volgende eigenschappen en methoden zijn vereist voor het implementeren van de IDockProvider-interface.

Vereiste leden	Ledentype	Opmerkingen
DockPosition	Vastgoed	Geen
SetDockPosition	Methode	Geen

Dit besturingspatroon heeft geen gekoppelde gebeurtenissen.

Uitzonderingen

Providers moeten de volgende uitzonderingen genereren.

Uitzonderingstype	Conditie
InvalidOperationException	SetDockPosition - Wanneer een besturingselement de aangevraagde dockstijl niet kan uitvoeren.

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