DesignSurface Klasse

Definition

Namespace:: System.ComponentModel.Design

Assembly:: System.Design.dll

Assembly:: System.Windows.Forms.Design.dll

Assemblys:: System.Design.dll, System.Windows.Forms.Design.dll

Quelle:: DesignSurface.cs

Quelle:: DesignSurface.cs

Quelle:: DesignSurface.cs

Quelle:: DesignSurface.cs

Quelle:: DesignSurface.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt eine Benutzeroberfläche zum Entwerfen von Komponenten dar.

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

Vererbung: Object
DesignSurface

Attribute: SecurityCriticalAttribute

Implementiert: IDisposable IServiceProvider

Hinweise

Die DesignSurface Klasse implementiert, was der Benutzer als Designer wahrnimmt. DesignSurface ist die Benutzeroberfläche, die der Benutzer bearbeitet, um Entwurfszeitfeatures zu ändern. DesignSurface bietet eine völlig eigenständige Designoberfläche.

Die DesignSurface Klasse kann als eigenständiger Designer verwendet werden, oder sie kann mit der DesignSurfaceManager Klasse gekoppelt werden, um eine gemeinsame Implementierung für eine Anwendung bereitzustellen, die mehrere DesignSurface Objekte hosten.

Die DesignSurface Klasse kann von sich selbst verwendet werden, oder der Benutzer kann eine neue Klasse daraus ableiten und das Verhalten erweitern.

Die DesignSurface Klasse stellt automatisch mehrere Entwurfszeitdienste bereit. Die DesignSurface Klasse fügt alle zugehörigen Dienste im Konstruktor hinzu. Die meisten dieser Dienste können überschrieben werden, indem sie in der geschützten ServiceContainer Eigenschaft ersetzt werden. Um einen Dienst zu ersetzen, setzen Sie den Konstruktor außer Kraft, rufen die Basis auf, und nehmen Sie alle Änderungen über die geschützte ServiceContainer Eigenschaft vor. Alle Dienste, die dem Dienstcontainer hinzugefügt werden und die implementiert IDisposable werden, werden verworfen, wenn die Entwurfsoberfläche verworfen wird. Der Standardsatz von austauschbaren Diensten, die von der DesignSurface Klasse bereitgestellt werden, wird in der folgenden Tabelle angezeigt.

Service	Beschreibung
IExtenderProviderService	Ermöglicht Objekten, die nicht Teil der Komponentenauflistung des Containers sind, ihre eigenen Extenderanbieter bereitzustellen.
IExtenderListService	Wird verwendet, TypeDescriptor um eine Liste der Erweiterungsanbieter abzurufen. Mit diesem Dienst können Extenderanbieter außerhalb des Containers leben.
ITypeDescriptorFilterService	Stellt Designermetadaten-Hooks bereit. Dies ist die primäre Schnittstelle für die Metadatenfilterung.
ISelectionService	Bietet eine Möglichkeit zum Auswählen von Komponenten im Designer.
IReferenceService	Bietet eine Möglichkeit, einen Namen für Objekte abzurufen, auch wenn diese Objekte nicht websiteiert sind.
DesignSurface	Bietet die Designoberfläche selbst als Service.
DesignerOptionService	Stellt eine Basisklasse zum Abrufen und Festlegen von Optionswerten für einen Designer bereit.

In der folgenden Tabelle sind die nicht ersetzbaren Dienste aufgeführt, die standardmäßig bereitgestellt werden.

Service	Beschreibung
IComponentChangeService	Löst Ereignisse aus, wenn Änderungen an Komponenten vorgenommen werden.
IDesignerHost	Steuert den Zugriff auf Typen, Dienste und Transaktionen. Primäre Schnittstelle für Designer.
IContainer	Besitzt den Satz von Komponenten, die entworfen werden. Jeder Designer verfügt über eine IContainer Komponente, die die Komponenten besitzt.
IServiceContainer	Abgeleitet von IServiceProvider und bietet eine Möglichkeit zum Hinzufügen und Entfernen von Diensten aus dem Designer.

Zusätzlich zu diesen Diensten stellt die DesignSurface Klasse auch einen einzelnen Dienst bereit, der über die Website einer Komponente verfügbar ist. Dieser Dienst ist für jede Komponente eindeutig. In der folgenden Tabelle sind die Dienste aufgeführt, die nicht ersetzt werden können.

Service	Beschreibung
IDictionaryService	Ein generisches Wörterbuch mit Schlüssel-Wert-Paaren, mit denen beliebige Daten zu einer Komponente gespeichert werden können.
INestedContainer	Ein Container, der es einer Komponente ermöglicht, dem Designer zusätzliche untergeordnete Komponenten hinzuzufügen. Diese Komponenten sind Teil der Entwurfsoberfläche, nehmen jedoch nicht an der Serialisierung teil. Dies ist nützlich, wenn Sie ein Steuerelement entwerfen möchten, das in der Lage ist, einen Bereich von sich selbst in einem Designer verfügbar zu machen, aber Sie möchten nicht, dass die Region an der Serialisierung teilnimmt.

Service

Beschreibung

IDictionaryService

Ein generisches Wörterbuch mit Schlüssel-Wert-Paaren, mit denen beliebige Daten zu einer Komponente gespeichert werden können.

INestedContainer

Ein Container, der es einer Komponente ermöglicht, dem Designer zusätzliche untergeordnete Komponenten hinzuzufügen. Diese Komponenten sind Teil der Entwurfsoberfläche, nehmen jedoch nicht an der Serialisierung teil. Dies ist nützlich, wenn Sie ein Steuerelement entwerfen möchten, das in der Lage ist, einen Bereich von sich selbst in einem Designer verfügbar zu machen, aber Sie möchten nicht, dass die Region an der Serialisierung teilnimmt.

Zusätzlich dazu ISiteimplementiert die Website auch die folgenden Schnittstellen.

Vorsicht

Überprüfen Sie, ob diese Schnittstellen vorhanden sind, anstatt eine diskriminierungslose Umwandlung zu verwenden, da andere Websiteimplementierungen sie möglicherweise nicht implementieren.

Service	Beschreibung
IServiceContainer	Bietet eine Möglichkeit, zum Container von standortspezifischen Diensten zu gelangen. Beispielsweise IDictionaryService handelt es sich um einen standortspezifischen Dienst. Mit diesem Dienst können Sie zusätzliche websitespezifische Dienste hinzufügen.

Konstruktoren

Name	Beschreibung
DesignSurface()	Initialisiert eine neue Instanz der DesignSurface-Klasse.
DesignSurface(IServiceProvider, Type)	Initialisiert eine neue Instanz der DesignSurface-Klasse.
DesignSurface(IServiceProvider)	Initialisiert eine neue Instanz der DesignSurface-Klasse.
DesignSurface(Type)	Initialisiert eine neue Instanz der DesignSurface-Klasse.

Eigenschaften

Name	Beschreibung
ComponentContainer	Ruft die IContainer Implementierung innerhalb der Entwurfsoberfläche ab.
DtelLoading	Ruft einen Wert ab, der angibt, ob die Entwurfszeitfehlerliste geladen wird.
IsLoaded	Ruft einen Wert ab, der angibt, ob die Entwurfsoberfläche derzeit geladen ist.
LoadErrors	Gibt eine Auflistung von Ladefehlern oder einer void -Auflistung zurück.
ServiceContainer	Ruft den Dienstcontainer ab.
View	Ruft die Ansicht für den Stamm-Designer ab.

Methoden

Name	Beschreibung
BeginLoad(DesignerLoader)	Beginnt mit dem Ladevorgang mit dem angegebenen Designerladeprogramm.
BeginLoad(Type)	Beginnt mit dem Ladevorgang.
CreateComponent(Type)	Veraltet. Erstellt eine Instanz einer Komponente.
CreateDesigner(IComponent, Boolean)	Erstellt einen Designer, wenn dem Container eine Komponente hinzugefügt wird.
CreateInstance(Type)	Erstellt eine Instanz des angegebenen Typs.
CreateNestedContainer(IComponent, String)	Erstellt einen Container, der für das Verschachteln von Steuerelementen oder Komponenten geeignet ist.
CreateNestedContainer(IComponent)	Erstellt einen Container, der für das Verschachteln von Steuerelementen oder Komponenten geeignet ist.
Dispose()	Gibt die von der DesignSurface.
Dispose(Boolean)	Gibt die von der DesignSurface.
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
Flush()	Serialisiert Änderungen an der Entwurfsoberfläche.
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetService(Type)	Ruft einen Dienst aus dem Dienstcontainer ab.
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
OnLoaded(LoadedEventArgs)	Löst das Loaded-Ereignis aus.
OnLoading(EventArgs)	Löst das Loading-Ereignis aus.
OnUnloaded(EventArgs)	Löst das Unloaded-Ereignis aus.
OnUnloading(EventArgs)	Löst das Unloading-Ereignis aus.
OnViewActivate(EventArgs)	Löst das ViewActivated-Ereignis aus.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Ereignisse

Name	Beschreibung
Disposed	Tritt auf, wenn die Entwurfsoberfläche verworfen wird.
Flushed	Tritt auf, wenn ein Aufruf an die Flush() Methode von DesignSurface.
Loaded	Tritt auf, wenn die Designerlade abgeschlossen wurde.
Loading	Tritt auf, wenn der Designer gerade geladen werden soll.
Unloaded	Tritt auf, wenn ein Designer die Entladung abgeschlossen hat.
Unloading	Tritt auf, wenn ein Designer gerade entladen wird.
ViewActivated	Tritt auf, wenn die Activate() Methode aufgerufen IDesignerHostwurde.

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?