Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

ComponentDesigner-Klasse

 

Veröffentlicht: Oktober 2016

Erweitert das Entwurfsmodusverhalten einer Komponente.

Namespace:   System.ComponentModel.Design
Assembly:  System.Design (in System.Design.dll)


public class ComponentDesigner : ITreeDesigner, IDesigner, IDisposable, 
	IDesignerFilter, IComponentInitializer

NameBeschreibung
System_CAPS_pubmethodComponentDesigner()

Initialisiert eine neue Instanz der ComponentDesigner-Klasse.

NameBeschreibung
System_CAPS_pubpropertyActionLists

Ruft die Entwurfszeit-Aktionslisten von der dem Designer zugeordneten Komponente unterstützt.

System_CAPS_pubpropertyAssociatedComponents

Ruft die Auflistung der Komponenten, die der durch den Designer verwalteten Komponente zugeordnet.

System_CAPS_pubpropertyComponent

Ruft die Komponente, die diesem Designer entworfen wird.

System_CAPS_protpropertyInheritanceAttribute

Ruft ein Attribut, das den Typ der Vererbung der zugeordneten Komponente angibt.

System_CAPS_protpropertyInherited

Ruft einen Wert, der angibt, ob diese Komponente geerbt wird.

System_CAPS_protpropertyParentComponent

Ruft die übergeordnete Komponente für diesen Designer ab.

System_CAPS_protpropertyShadowProperties

Ruft eine Auflistung von Eigenschaftswerten, die benutzereinstellungen außer Kraft gesetzt.

System_CAPS_pubpropertyVerbs

Ruft die Entwurfszeitverben unterstützt, die von der Komponente, die dem Designer zugeordnet ist.

NameBeschreibung
System_CAPS_pubmethodDispose()

Gibt alle vom ComponentDesigner verwendeten Ressourcen frei.

System_CAPS_protmethodDispose(Boolean)

Gibt die von ComponentDesigner verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.

System_CAPS_pubmethodDoDefaultAction()

Erstellt eine Methodensignatur in der Quellcodedatei für das Standardereignis für die Komponente und den Cursor des Benutzers an diesen Speicherort navigiert.

System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von „Object“.)

System_CAPS_protmethodFinalize()

Versucht, durch Aufrufen von Dispose(false) Ressourcen freizugeben, bevor das Objekt durch die Garbage Collection wieder zugänglich gemacht wird.(Überschreibt Object.Finalize().)

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von „Object“.)

System_CAPS_protmethodGetService(Type)

Versucht, den angegebenen Diensttyp von der Entwurfsmodussite der Komponente des Designers abzurufen.

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodInitialize(IComponent)

Bereitet den Designer zum Anzeigen, bearbeiten und Entwerfen der angegebenen Komponente vor.

System_CAPS_pubmethodInitializeExistingComponent(IDictionary)

Initialisiert eine vorhandene Komponente erneut.

System_CAPS_pubmethodInitializeNewComponent(IDictionary)

Initialisiert eine neu erstellte Komponente.

System_CAPS_pubmethodInitializeNonDefault()

Veraltet. Initialisiert die Einstellungen für eine importierte Komponente, die bereits mit Einstellungen als die Standardwerte initialisiert wird.

System_CAPS_protmethodInvokeGetInheritanceAttribute(ComponentDesigner)

Ruft die InheritanceAttribute des angegebenen ComponentDesigner.

System_CAPS_protmethodMemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.(Geerbt von „Object“.)

System_CAPS_pubmethodOnSetComponentDefaults()

Veraltet. Legt die Standardeigenschaften für die Komponente fest.

System_CAPS_protmethodPostFilterAttributes(IDictionary)

Ermöglicht einem Designer das Ändern oder Entfernen von Elementen aus dem Satz von Attributen, die über macht eine TypeDescriptor.

System_CAPS_protmethodPostFilterEvents(IDictionary)

Ermöglicht einem Designer das Ändern oder Entfernen von Elementen aus dem Satz von Ereignissen über einen TypeDescriptor.

System_CAPS_protmethodPostFilterProperties(IDictionary)

Ermöglicht einem Designer das Ändern oder Entfernen von Elementen aus dem Satz von Eigenschaften, die über macht eine TypeDescriptor.

System_CAPS_protmethodPreFilterAttributes(IDictionary)

Ermöglicht es einem Designer, um den Satz von Attributen hinzufügen, die über verfügbar ein TypeDescriptor.

System_CAPS_protmethodPreFilterEvents(IDictionary)

Ermöglicht es einem Designer, um den Satz der Ereignisse hinzufügen, die über verfügbar ein TypeDescriptor.

System_CAPS_protmethodPreFilterProperties(IDictionary)

Ermöglicht es einem Designer, um den Satz von Eigenschaften hinzufügen, die über verfügbar ein TypeDescriptor.

System_CAPS_protmethodRaiseComponentChanged(MemberDescriptor, Object, Object)

Benachrichtigt die IComponentChangeService die diese Komponente geändert wurde.

System_CAPS_protmethodRaiseComponentChanging(MemberDescriptor)

Benachrichtigt die IComponentChangeService dass diese Komponente geändert wird.

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

NameBeschreibung
System_CAPS_pubinterfaceSystem_CAPS_privmethodIDesignerFilter.PostFilterAttributes(IDictionary)

Eine Beschreibung dieses Members finden Sie unter der IDesignerFilter.PostFilterAttributes-Methode.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDesignerFilter.PostFilterEvents(IDictionary)

Eine Beschreibung dieses Members finden Sie unter der IDesignerFilter.PostFilterEvents-Methode.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDesignerFilter.PostFilterProperties(IDictionary)

Eine Beschreibung dieses Members finden Sie unter der IDesignerFilter.PostFilterProperties-Methode.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDesignerFilter.PreFilterAttributes(IDictionary)

Eine Beschreibung dieses Members finden Sie unter der IDesignerFilter.PreFilterAttributes-Methode.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDesignerFilter.PreFilterEvents(IDictionary)

Eine Beschreibung dieses Members finden Sie unter der IDesignerFilter.PreFilterEvents-Methode.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDesignerFilter.PreFilterProperties(IDictionary)

Eine Beschreibung dieses Members finden Sie unter der IDesignerFilter.PreFilterProperties-Methode.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyITreeDesigner.Children

Eine Beschreibung dieses Elements finden Sie in der ITreeDesigner.Children Eigenschaft.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyITreeDesigner.Parent

Eine Beschreibung dieses Elements finden Sie in der ITreeDesigner.Parent Eigenschaft.

The T:System.ComponentModel.Design.ComponentDesigner base designer class provides a simple designer that can extend the behavior of an associated component in design mode.

ComponentDesigner provides an empty IDesignerFilter interface implementation, whose methods can be overridden to adjust the attributes, properties and events of the associated component at design time.

You can associate a designer with a type using a T:System.ComponentModel.DesignerAttribute. For an overview of customizing design-time behavior, see Extending Design-Time Support.

The T:System.ComponentModel.Design.ComponentDesigner class implements a special behavior for the property descriptors of inherited components. An internal type named InheritedPropertyDescriptor is used by the default T:System.ComponentModel.Design.ComponentDesigner implementation to stand in for properties that are inherited from a base class. There are two cases in which these property descriptors are added.

  1. To the root object itself, which is returned by the P:System.ComponentModel.Design.IDesignerHost.RootComponent property, because you are inheriting from its base class.

  2. To fields found in the base class of the root object. Public and protected fields from the base class are added to the designer so that they can be manipulated by the user.

The InheritedPropertyDescriptor class modifies the default value of a property, so that the default value is the current value at object instantiation. This is because the property is inherited from another instance. The designer defines resetting the property value as setting it to the value that was set by the inherited class. This value may differ from the default value stored in metadata.

The following code example provides an example T:System.ComponentModel.Design.ComponentDesigner implementation and an example component associated with the designer. The designer implements an override of the M:System.ComponentModel.Design.ComponentDesigner.Initialize(System.ComponentModel.IComponent) method that calls the base Initialize method, an override of the M:System.ComponentModel.Design.ComponentDesigner.DoDefaultAction method that displays a T:System.Windows.Forms.MessageBox when the component is double-clicked, and an override of the P:System.ComponentModel.Design.ComponentDesigner.Verbs property accessor that supplies a custom T:System.ComponentModel.Design.DesignerVerb menu command to the shortcut menu for the component.

using System;
using System.Collections;
using System.ComponentModel;
using System.ComponentModel.Design;
using System.Drawing;
using System.Windows.Forms;

namespace ExampleComponent
{	
    // Provides an example component designer.
    public class ExampleComponentDesigner : System.ComponentModel.Design.ComponentDesigner
    {
        public ExampleComponentDesigner()
        {
        }

        // This method provides an opportunity to perform processing when a designer is initialized.
        // The component parameter is the component that the designer is associated with.
        public override void Initialize(System.ComponentModel.IComponent component)
        {
            // Always call the base Initialize method in an override of this method.
            base.Initialize(component);
        }

        // This method is invoked when the associated component is double-clicked.
        public override void DoDefaultAction()
        {
            MessageBox.Show("The event handler for the default action was invoked.");
        }

        // This method provides designer verbs.
        public override System.ComponentModel.Design.DesignerVerbCollection Verbs
        {
            get
            {
                return new DesignerVerbCollection( new DesignerVerb[] { new DesignerVerb("Example Designer Verb Command", new EventHandler(this.onVerb)) } );
            }
        }

        // Event handling method for the example designer verb
        private void onVerb(object sender, EventArgs e)
        {
            MessageBox.Show("The event handler for the Example Designer Verb Command was invoked.");
        }
    }

    // Provides an example component associated with the example component designer.
    [DesignerAttribute(typeof(ExampleComponentDesigner), typeof(IDesigner))]
    public class ExampleComponent : System.ComponentModel.Component
    {		
        public ExampleComponent()
        {
        }
    }
}

.NET Framework
Verfügbar seit 1.1

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: