Het patroon dockbeheer van de gebruikersinterface van de gebruikersinterface 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 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 Beheerpatroontoewijzing voor UI Automation-clients voor 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. Als Top dit bijvoorbeeld is opgegeven, worden de linker- en rechterkant van het besturingselement uitgebreid om alle beschikbare ruimte te vullen. Als Fill dit is opgegeven, worden alle vier de zijden van het besturingselement 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 | Type lid | Opmerkingen |
|---|---|---|
| DockPosition | Eigenschappen | Geen |
| SetDockPosition | Wijze | 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. |