DesignSurface Klas

Definitie

Naamruimte:
System.ComponentModel.Design
Assembly:
System.Design.dll

Biedt een gebruikersinterface voor het ontwerpen van onderdelen.

public ref class DesignSurface : IDisposable, IServiceProvider
public class DesignSurface : IDisposable, IServiceProvider
[System.Security.SecurityCritical]
public class DesignSurface : IDisposable, IServiceProvider
type DesignSurface = class
    interface IDisposable
    interface IServiceProvider
[<System.Security.SecurityCritical>]
type DesignSurface = class
    interface IDisposable
    interface IServiceProvider
Public Class DesignSurface
Implements IDisposable, IServiceProvider
Overname
Object
DesignSurface
Kenmerken
SecurityCriticalAttribute
Implementeringen
IDisposable IServiceProvider

Opmerkingen

De DesignSurface klasse implementeert wat de gebruiker als ontwerper waarneemt. DesignSurface is de gebruikersinterface die de gebruiker bewerkt om ontwerp-tijdfuncties te wijzigen. DesignSurface biedt een volledig zelfstandig ontwerpoppervlak.

De DesignSurface klasse kan worden gebruikt als zelfstandige ontwerper of kan worden gekoppeld aan de DesignSurfaceManager klasse om een algemene implementatie te bieden voor een toepassing die als host fungeert voor meerdere DesignSurface objecten.

De DesignSurface klasse kan op zichzelf worden gebruikt of de gebruiker kan een nieuwe klasse ervan afleiden en het gedrag uitbreiden.

De DesignSurface klasse biedt automatisch verschillende ontwerptijdservices. De DesignSurface klasse voegt alle services in de constructor toe. De meeste van deze services kunnen worden overschreven door ze te vervangen in de beveiligde ServiceContainer eigenschap. Als u een service wilt vervangen, moet u de constructor overschrijven, basis aanroepen en wijzigingen aanbrengen via de beveiligde ServiceContainer eigenschap. Alle services die worden toegevoegd aan de servicecontainer en die implementeren IDisposable , worden verwijderd wanneer het ontwerpoppervlak wordt verwijderd. De standaardset van vervangende services die door de DesignSurface klasse worden geleverd, wordt weergegeven in de volgende tabel.

Dienst Beschrijving
IExtenderProviderService Hiermee kunnen objecten die geen deel uitmaken van de verzameling onderdelen van de container hun eigen extender-providers leveren.
IExtenderListService TypeDescriptor Wordt gebruikt om een lijst met extender-providers op te halen. Met deze service kunnen extender-providers buiten de container wonen.
ITypeDescriptorFilterService Biedt metagegevenshook van de ontwerper. Dit is de primaire interface voor het filteren van metagegevens.
ISelectionService Biedt een manier om onderdelen in de ontwerpfunctie te selecteren.
IReferenceService Biedt een manier om een naam voor objecten op te halen, zelfs als deze objecten niet zijn gesitemd.
DesignSurface Biedt het ontwerpoppervlak zelf als een dienst.
DesignerOptionService Biedt een basisklasse voor het ophalen en instellen van optiewaarden voor een ontwerper.

In de volgende tabel ziet u de niet-vervangbare services die standaard worden geleverd.

Dienst Beschrijving
IComponentChangeService Hiermee worden gebeurtenissen gegenereerd wanneer er wijzigingen worden aangebracht in onderdelen.
IDesignerHost Hiermee bepaalt u de toegang tot typen, services en transacties. Primaire interface voor ontwerpers.
IContainer Is eigenaar van de set onderdelen die worden ontworpen. Elke ontwerper heeft een IContainer ontwerpfunctie die eigenaar is van de onderdelen.
IServiceContainer Is afgeleid van IServiceProvider en biedt een manier om services toe te voegen en te verwijderen uit de ontwerpfunctie.

Naast deze services biedt de DesignSurface klasse ook één service die beschikbaar is via de site van een onderdeel. Deze service is uniek voor elk onderdeel. In de volgende tabel ziet u de services die niet kunnen worden vervangen.

Dienst Beschrijving
IDictionaryService Een algemene woordenlijst van sleutel-waardeparen die kunnen worden gebruikt om willekeurige gegevens over een onderdeel op te slaan.
INestedContainer Een container waarmee een onderdeel aanvullende onderliggende onderdelen aan de ontwerpfunctie kan toevoegen. Deze onderdelen maken deel uit van het ontwerpoppervlak, maar nemen geen deel aan serialisatie. Dit is handig als u een besturingselement wilt ontwerpen dat in staat is om een regio van zichzelf beschikbaar te maken in een ontwerper, maar u niet wilt dat de regio deelneemt aan serialisatie.

Daarnaast ISiteimplementeert de site ook de volgende interfaces.

Caution

Controleer of deze interfaces bestaan, in plaats van gebruik te maken van ondiscriminatie, omdat andere site-implementaties deze mogelijk niet implementeren.

Dienst Beschrijving
IServiceContainer Biedt een manier om naar de container met sitespecifieke services te gaan. Is bijvoorbeeld IDictionaryService een sitespecifieke service. Met deze service kunt u aanvullende sitespecifieke services toevoegen.

Constructors

Name Description
DesignSurface()

Initialiseert een nieuw exemplaar van de DesignSurface klasse.
DesignSurface(IServiceProvider, Type)

Initialiseert een nieuw exemplaar van de DesignSurface klasse.
DesignSurface(IServiceProvider)

Initialiseert een nieuw exemplaar van de DesignSurface klasse.
DesignSurface(Type)

Initialiseert een nieuw exemplaar van de DesignSurface klasse.

Eigenschappen

Name Description
ComponentContainer

Hiermee haalt u de IContainer implementatie binnen het ontwerpoppervlak op.
DtelLoading

Hiermee wordt een waarde opgehaald die aangeeft of de lijst met ontwerpfouten wordt geladen.
IsLoaded

Hiermee wordt een waarde opgehaald die aangeeft of het ontwerpoppervlak momenteel is geladen.
LoadErrors

Retourneert een verzameling laadfouten of een ongeldige verzameling.
ServiceContainer

Hiermee haalt u de servicecontainer op.
View

Hiermee haalt u de weergave voor de hoofdontwerper op.

Methoden

Name Description
BeginLoad(DesignerLoader)

Begint het laadproces met het opgegeven ontwerplaadprogramma.
BeginLoad(Type)

Het laadproces wordt gestart.
CreateComponent(Type)
Verouderd.

Hiermee maakt u een exemplaar van een onderdeel.
CreateDesigner(IComponent, Boolean)

Hiermee maakt u een ontwerpfunctie wanneer een onderdeel wordt toegevoegd aan de container.
CreateInstance(Type)

Hiermee maakt u een exemplaar van het opgegeven type.
CreateNestedContainer(IComponent, String)

Hiermee maakt u een container die geschikt is voor het nesten van besturingselementen of onderdelen.
CreateNestedContainer(IComponent)

Hiermee maakt u een container die geschikt is voor het nesten van besturingselementen of onderdelen.
Dispose()

Releases van de resources die worden gebruikt door de DesignSurface.
Dispose(Boolean)

Releases van de resources die worden gebruikt door de DesignSurface.
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
Flush()

Serialiseert wijzigingen in het ontwerpoppervlak.
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetService(Type)

Hiermee haalt u een service op uit de servicecontainer.
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
OnLoaded(LoadedEventArgs)

Hiermee wordt de Loaded gebeurtenis gegenereerd.
OnLoading(EventArgs)

Hiermee wordt de Loading gebeurtenis gegenereerd.
OnUnloaded(EventArgs)

Hiermee wordt de Unloaded gebeurtenis gegenereerd.
OnUnloading(EventArgs)

Hiermee wordt de Unloading gebeurtenis gegenereerd.
OnViewActivate(EventArgs)

Hiermee wordt de ViewActivated gebeurtenis gegenereerd.
ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)

gebeurtenis

Name Description
Disposed

Treedt op wanneer het ontwerpoppervlak wordt verwijderd.
Flushed

Treedt op wanneer een aanroep wordt gedaan naar de Flush() methode van DesignSurface.
Loaded

Treedt op wanneer het laden van de ontwerpfunctie is voltooid.
Loading

Treedt op wanneer de ontwerpfunctie op het punt staat te worden geladen.
Unloaded

Treedt op wanneer een ontwerper klaar is met lossen.
Unloading

Treedt op wanneer een ontwerper op het punt staat om te laden.
ViewActivated

Treedt op wanneer de Activate() methode is aangeroepen IDesignerHost.

Van toepassing op

Zie ook