DesignerRegion Klasse

  • Referenz

Definition

Namespace:
System.Web.UI.Design
Assembly:
System.Design.dll

Definiert einen Bereich des Inhalts innerhalb des Entwurfszeitmarkups für das zugeordnete Steuerelement.

public ref class DesignerRegion : System::Web::UI::Design::DesignerObject
public class DesignerRegion : System.Web.UI.Design.DesignerObject
type DesignerRegion = class
    inherit DesignerObject
Public Class DesignerRegion
Inherits DesignerObject
Vererbung
Object
DesignerObject
DesignerRegion
Abgeleitet

Hinweise

Das- DesignerRegion Objekt stellt einen Inhalts Bereich innerhalb des Entwurfszeit Markups dar, der von einer-Implementierung generiert wird ControlDesigner . Ein Steuerelement Entwickler verwendet Designer Bereiche in einer benutzerdefinierten ControlDesigner -Implementierung, um separate Bereiche im Entwurfszeit Markup für das zugeordnete Steuerelement zu definieren und Bearbeitungs-und Ereignis Behandlung für den Bereich bereitzustellen. Ein visueller Designer, z. b. Visual Studio 2005, kann Designer Bereiche verwenden, um die separaten Bereiche eines Steuer Elements auf der Entwurfs Oberfläche anzuzeigen und Benutzer Ereignisse für den Bereich im Steuerelement-Designer aufzurufen. Designer Bereiche können eine Implementierung des Steuerelement-Designers vereinfachen, da viele Regions basierte Funktionen von den Basis-Designer-Klassen und vom visuellen Designer bereitgestellt werden.

Die- DesignerRegion Klasse stellt die Basisfunktionalität für Designer Bereiche bereit, z. b. die Möglichkeit, auf der Entwurfs Oberfläche auf einen Bereich zu klicken, auszuwählen und ihn hervorzuheben. Verwenden Sie ein- DesignerRegion Objekt in einer Steuerelement-Designer-Implementierung, um einen Bereich zu definieren, der keine Bearbeitung erfordert. Verwenden Sie die abgeleitete EditableDesignerRegion Klasse in einer Steuerelement-Designer-Implementierung, um einen Bereich mit bearbeitbaren Inhalt zur Entwurfszeit zu definieren. Mit der abgeleiteten TemplatedEditableDesignerRegion Klasse in einer Steuerelement-Designer-Implementierung können Sie einen bearbeitbaren Bereich definieren, der eine Vorlage in einem-Steuerelement darstellt.

Um Bereiche innerhalb einer Klasse zu unterstützen, die von abgeleitet ist ControlDesigner , überschreiben Sie die GetDesignTimeHtml -Methode, und fügen Sie der Auflistung ein oder mehrere initialisierte DesignerRegion Objekte hinzu DesignerRegionCollection . Optional können Sie Mausklicks in den Bereichen auf der Entwurfs Oberfläche behandeln, indem Sie die-Methode überschreiben OnClick .

Verwenden Sie die Eigenschaften eines- DesignerRegion Objekts, um zu bestimmen, wie der Bereich vom visuellen Designer angezeigt wird. Überschreiben Selectable Sie die-Eigenschaft, um anzugeben, dass der Bereich vom Benutzer auf der Entwurfs Oberfläche ausgewählt werden kann. Verwenden Sie die- Highlight Eigenschaft, um den Designer Bereich im visuellen Designer hervorzuheben. Sie können z. b. einen Bereich markieren, nachdem ein Benutzer darauf geklickt hat, ihn auszuwählen. Verwenden DisplayName Sie die-Eigenschaft und die-Eigenschaft Description , um zusätzliche Details über den Bereich zu speichern oder abzurufen Insbesondere wird die- Description Eigenschaft vom visuellen Designer verwendet, um QuickInfo-Informationen anzuzeigen, wenn der Benutzer den Mauszeiger über den Designer Bereich bewegt. Verwenden Sie die- Designer Eigenschaft, um auf die Methoden und Eigenschaften des Steuerelement-Designer-Objekts zuzugreifen, das den Designer Bereich enthält.

Konstruktoren

DesignerRegion(ControlDesigner, String)

Initialisiert eine neue Instanz der DesignerRegion-Klasse mit dem angegebenen Namen für einen Steuerelement-Designer.
DesignerRegion(ControlDesigner, String, Boolean)

Initialisiert eine neue Instanz der DesignerRegion-Klasse mit dem angegebenen Namen für einen Steuerelement-Designer und legt optional die Instanz als auswählbaren Bereich im Designer fest.

Felder

DesignerRegionAttributeName

Definiert den HTML-Attributnamen für einen Designerbereich.

Eigenschaften

Description

Ruft die Beschreibung für einen Designerbereich ab oder legt diese fest.
Designer

Ruft die zugeordnete Designerkomponente ab.

(Geerbt von DesignerObject)
DisplayName

Ruft den benutzerfreundlichen Anzeigenamen für einen Designerbereich ab oder legt diesen fest.
EnsureSize

Ruft einen Wert ab, der angibt, ob die Bereichsgröße explizit vom Designhost für den Designerbereich festgelegt werden soll, oder legt diesen fest.
Highlight

Ruft einen Wert ab, der angibt, ob der Designerbereich auf der Entwurfsoberfläche hervorgehoben werden soll, oder legt diesen fest.
Name

Ruft den Namen des Objekts ab.

(Geerbt von DesignerObject)
Properties

Ruft die Eigenschaften des Objekts ab.

(Geerbt von DesignerObject)
Selectable

Ruft einen Wert ab, der angibt, ob der Designerbereich auf der Entwurfsoberfläche von Benutzern ausgewählt werden kann, oder legt diesen fest.
Selected

Ruft einen Wert ab, der angibt, ob der Designerbereich derzeit auf der Entwurfsoberfläche ausgewählt ist, oder legt diesen fest.
UserData

Ruft optionale Benutzerdaten ab, die dem Designerbereich zugeordnet werden sollen, oder legt diese fest.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetBounds()

Ruft die Größe des Designerbereichs auf der Entwurfsoberfläche ab.
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetService(Type)

Ruft einen Dienst vom Entwurfshost entsprechend dem bereitgestellten Typ ab.

(Geerbt von DesignerObject)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

IServiceProvider.GetService(Type)

Eine Beschreibung dieses Elements finden Sie unter GetService(Type).

(Geerbt von DesignerObject)

Gilt für

Siehe auch