DesignSurface Klasse

Definition

Stellt eine Benutzeroberfläche zum Entwerfen von Komponenten dar.Presents a user interface for designing components.

public ref class DesignSurface : IDisposable, IServiceProvider
[System.Security.SecurityCritical]
public class DesignSurface : IDisposable, IServiceProvider
type DesignSurface = class
    interface IDisposable
    interface IServiceProvider
Public Class DesignSurface
Implements IDisposable, IServiceProvider
Vererbung
DesignSurface
Attribute
Implementiert

Hinweise

Die DesignSurface -Klasse implementiert, was der Benutzer als Designer wahrnimmt.The DesignSurface class implements what the user perceives as a designer. DesignSurfacedie Benutzeroberfläche, die der Benutzer bearbeitet, um Entwurfszeit Features zu ändern.DesignSurface is the user interface the user manipulates to change design-time features. DesignSurfacestellt eine vollständig eigenständige Entwurfs Oberfläche bereit.DesignSurface provides a completely self-contained design surface.

Die DesignSurface Klasse kann als eigenständiger Designer verwendet werden, oder Sie kann mit der DesignSurfaceManager -Klasse gekoppelt werden, um eine gängige Implementierung für eine Anwendung bereitzustellen, die DesignSurface mehrere-Objekte hostet.The DesignSurface class may be used as a stand-alone designer, or it may be coupled with the DesignSurfaceManager class to provide a common implementation for an application that hosts multiple DesignSurface objects.

Die DesignSurface Klasse kann eigenständig verwendet werden, oder der Benutzer kann eine neue Klasse davon ableiten und das Verhalten erweitern.The DesignSurface class can be used by itself, or the user can derive a new class from it and augment the behavior.

Die DesignSurface -Klasse stellt mehrere Entwurfszeit Dienste automatisch bereit.The DesignSurface class provides several design-time services automatically. Die DesignSurface -Klasse fügt alle zugehörigen Dienste in ihren Konstruktor ein.The DesignSurface class adds all of its services in its constructor. Die meisten dieser Dienste können überschrieben werden, indem Sie in der geschützten ServiceContainer Eigenschaft ersetzt werden.Most of these services can be overridden by replacing them in the protected ServiceContainer property. Um einen Dienst zu ersetzen, überschreiben Sie den Konstruktor, die callbase, und nehmen Sie ServiceContainer alle Änderungen über die geschützte Eigenschaft vor.To replace a service, override the constructor, call base, and make any changes through the protected ServiceContainer property. Alle Dienste, die dem Dienst Container hinzugefügt und implementiert IDisposable werden, werden verworfen, wenn die Entwurfs Oberfläche verworfen wird.All services that are added to the service container and that implement IDisposable are disposed when the design surface is disposed. In der folgenden Tabelle wird der Standardsatz von DesignSurface ersetzbaren Diensten angezeigt, der von der-Klasse bereitgestellt wird.The default set of replaceable services that the DesignSurface class provides is shown in the following table.

DienstService BeschreibungDescription
IExtenderProviderService Ermöglicht es Objekten, die nicht Teil der Komponenten Auflistung des Containers sind, ihre eigenen Extenderanbieter bereitzustellen.Enables objects that are not part of the container's components collection to provide their own extender providers.
IExtenderListService Wird von TypeDescriptor verwendet, um eine Liste der Extender-Anbieter zu erhalten.Used by TypeDescriptor to get a list of extender providers. Mit diesem Dienst können Extenderanbieter außerhalb des Containers Leben.With this service, extender providers can live outside of the container.
ITypeDescriptorFilterService Stellt Designer-metadatenhooks bereit.Provides designer metadata hooks. Dies ist die primäre Schnittstelle für das Filtern von Metadaten.This is the primary interface for metadata filtering.
ISelectionService Bietet eine Möglichkeit, Komponenten im Designer auszuwählen.Provides a way to select components in the designer.
IReferenceService Bietet eine Möglichkeit, einen Namen für-Objekte zu erhalten, auch wenn diese Objekte nicht positioniert sind.Provides a way to get a name for objects, even when those objects are not sited.
DesignSurface Stellt die Entwurfs Oberfläche selbst als Dienst zur Verfügung.Offers the design surface itself as a service.
DesignerOptionService Stellt eine Basisklasse für Abruf und Festlegung von Optionswerten für einen Designer bereit.Provides a base class for getting and setting option values for a designer.

In der folgenden Tabelle sind die standardmäßig bereitgestellten nicht ersetzbaren Dienste aufgeführt.The following table shows the non-replaceable services provided by default.

DienstService BeschreibungDescription
IComponentChangeService Löst Ereignisse aus, wenn Änderungen an den Komponenten vorgenommen werden.Raises events as changes are made to components.
IDesignerHost Steuert den Zugriff auf Typen, Dienste und Transaktionen.Controls access to types, services, and transactions. Master Schnittstelle für Designer.Master interface for designers.
IContainer Besitzt den Satz von Komponenten, die entworfen werden.Owns the set of components that are being designed. Jeder Designer verfügt über IContainer eine, die die Komponenten besitzt.Each designer has an IContainer that owns the components.
IServiceContainer Wird von IServiceProvider abgeleitet und bietet eine Möglichkeit zum Hinzufügen und Entfernen von Diensten aus dem Designer.Derives from IServiceProvider and provides a way to add and remove services from the designer.

Zusätzlich zu diesen Diensten stellt die- DesignSurface Klasse auch einen einzelnen Dienst bereit, der über die Website einer Komponente verfügbar ist.In addition to these services, the DesignSurface class also provides a single service that is available through a component's site. Dieser Dienst ist für jede Komponente eindeutig.This service is unique for each component. In der folgenden Tabelle werden die Dienste aufgeführt, die nicht ersetzt werden können.The following table shows the services that cannot be replaced.

DienstService BeschreibungDescription
IDictionaryService Ein generisches Wörterbuch von Schlüssel-Wert-Paaren, das zum Speichern beliebiger Daten über eine Komponente verwendet werden kann.A generic dictionary of key/value pairs that can be used to store arbitrary data about a component.
INestedContainer Ein Container, der einer Komponente das Hinzufügen zusätzlicher untergeordneter Komponenten zum Designer ermöglicht.A container that enables a component to add additional child components to the designer. Diese Komponenten sind Teil der Entwurfs Oberfläche, werden jedoch nicht an der Serialisierung teilnehmen.These components will be part of the design surface, but will not participate in serialization. Dies ist hilfreich, wenn Sie ein Steuerelement entwerfen möchten, mit dem ein Bereich von sich selbst in einem Designer verfügbar gemacht werden kann, Sie aber nicht möchten, dass der Bereich an der Serialisierung teilnimmt.This is useful when you want to design a control that is capable of exposing a region of itself in a designer, but you do not want the region to participate in serialization.

Zusätzlich zu werden ISitevon der Site auch die folgenden Schnittstellen implementiert.In addition to ISite, the site also implements the following interfaces.

Achtung

Überprüfen Sie, ob diese Schnittstellen vorhanden sind, anstatt eine willkürliche Umwandlung zu verwenden, da Sie von anderen Site Implementierungen möglicherweise nicht implementiert werden.Check for the existence of these interfaces, rather than use indiscriminate casting, because other site implementations may not implement them.

DienstService BeschreibungDescription
IServiceContainer Bietet eine Möglichkeit, zum Container von Site spezifischen Diensten zu gelangen.Provides a way to get to the container of site-specific services. Beispielsweise IDictionaryService ist ein Site spezifischer Dienst.For example, IDictionaryService is a site-specific service. Mit diesem Dienst können Sie weitere standortspezifische Dienste hinzufügen.With this service, you can add additional site-specific services.

Konstruktoren

DesignSurface()

Initialisiert eine neue Instanz der DesignSurface-Klasse.Initializes a new instance of the DesignSurface class.

DesignSurface(IServiceProvider)

Initialisiert eine neue Instanz der DesignSurface-Klasse.Initializes a new instance of the DesignSurface class.

DesignSurface(IServiceProvider, Type)

Initialisiert eine neue Instanz der DesignSurface-Klasse.Initializes a new instance of the DesignSurface class.

DesignSurface(Type)

Initialisiert eine neue Instanz der DesignSurface-Klasse.Initializes a new instance of the DesignSurface class.

Eigenschaften

ComponentContainer

Ruft die IContainer-Implementierung innerhalb der Entwurfsoberfläche ab.Gets the IContainer implementation within the design surface.

DtelLoading

Ruft einen Wert ab, der angibt, ob die Entwurfszeitfehlerliste geladen wird.Gets a value indicating whether the Design-time Error List is loading.

IsLoaded

Ruft einen Wert ab, der angibt, ob die Entwurfsoberfläche gegenwärtig geladen ist.Gets a value indicating whether the design surface is currently loaded.

LoadErrors

Gibt eine Auflistung von während des Ladevorgangs aufgetretenen Fehlern oder eine leere Auflistung zurück.Returns a collection of loading errors or a void collection.

ServiceContainer

Ruft den Dienstcontainer ab.Gets the service container.

View

Ruft die Ansicht für den Stammdesigner ab.Gets the view for the root designer.

Methoden

BeginLoad(DesignerLoader)

Beginnt den Ladevorgang mit dem angegebenen Designerladeprogramm.Begins the loading process with the given designer loader.

BeginLoad(Type)

Beginnt den Ladevorgang.Begins the loading process.

CreateComponent(Type)

Erstellt eine Instanz einer Komponente.Creates an instance of a component.

CreateDesigner(IComponent, Boolean)

Erstellt einen Designer, wenn dem Container eine Komponente hinzugefügt wird.Creates a designer when a component is added to the container.

CreateInstance(Type)

Erstellt eine Instanz des angegebenen Typs.Creates an instance of the given type.

CreateNestedContainer(IComponent)

Erstellt einen für die Schachtelung von Steuerelementen oder Komponenten geeigneten Container.Creates a container suitable for nesting controls or components.

CreateNestedContainer(IComponent, String)

Erstellt einen für die Schachtelung von Steuerelementen oder Komponenten geeigneten Container.Creates a container suitable for nesting controls or components.

Dispose()

Gibt die von der DesignSurface verwendeten Ressourcen frei.Releases the resources used by the DesignSurface.

Dispose(Boolean)

Gibt die von der DesignSurface verwendeten Ressourcen frei.Releases the resources used by the DesignSurface.

Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
Flush()

Serialisiert an der Entwurfsoberfläche vorgenommene Änderungen.Serializes changes to the design surface.

GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetService(Type)

Ruft einen Dienst vom Dienstcontainer ab.Gets a service from the service container.

GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
OnLoaded(LoadedEventArgs)

Löst das Loaded-Ereignis aus.Raises the Loaded event.

OnLoading(EventArgs)

Löst das Loading -Ereignis aus.Raises the Loading event.

OnUnloaded(EventArgs)

Löst das Unloaded-Ereignis aus.Raises the Unloaded event.

OnUnloading(EventArgs)

Löst das Unloading -Ereignis aus.Raises the Unloading event.

OnViewActivate(EventArgs)

Löst das ViewActivated-Ereignis aus.Raises the ViewActivated event.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Ereignisse

Disposed

Tritt auf, wenn die Entwurfsoberfläche verworfen wird.Occurs when the design surface is disposed.

Flushed

Tritt auf, wenn die Flush()-Methode von DesignSurface aufgerufen wird.Occurs when a call is made to the Flush() method of DesignSurface.

Loaded

Tritt auf, wenn der Ladevorgang des Designers abgeschlossen wurde.Occurs when the designer load has completed.

Loading

Tritt auf, wenn der Designer gerade geladen wird.Occurs when the designer is about to be loaded.

Unloaded

Tritt auf, wenn ein Designer vollständig entladen wurde.Occurs when a designer has finished unloading.

Unloading

Tritt auf, wenn ein Designer gerade entladen wird.Occurs when a designer is about to unload.

ViewActivated

Tritt auf, wenn die Activate()-Methode für IDesignerHost aufgerufen wurde.Occurs when the Activate() method has been called on IDesignerHost.

Sicherheit

NamedPermissionSet
für vollständigen Zugriff auf Systemressourcen.for full access to system resources. Anforderungs Werte: LinkDemand, InheritanceDemand.Demand values: LinkDemand, InheritanceDemand. Zugeordneter Status:Associated state:

Gilt für:

Siehe auch