Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase ComponentDesigner

 

Publicado: octubre de 2016

Extiende el comportamiento de un componente en modo de diseño.

Espacio de nombres:   System.ComponentModel.Design
Ensamblado:  System.Design (en System.Design.dll)


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

NombreDescripción
System_CAPS_pubmethodComponentDesigner()

Inicializa una nueva instancia de la clase ComponentDesigner.

NombreDescripción
System_CAPS_pubpropertyActionLists

Obtiene las listas de acciones en tiempo de diseño que admite el componente asociado al diseñador.

System_CAPS_pubpropertyAssociatedComponents

Obtiene la colección de componentes asociados al componente administrado por el diseñador.

System_CAPS_pubpropertyComponent

Obtiene el componente que diseñador está diseñando.

System_CAPS_protpropertyInheritanceAttribute

Obtiene un atributo que indica el tipo de herencia del componente asociado.

System_CAPS_protpropertyInherited

Obtiene un valor que indica si este componente es heredado.

System_CAPS_protpropertyParentComponent

Obtiene el componente primario de este diseñador.

System_CAPS_protpropertyShadowProperties

Obtiene una colección de valores de propiedad que reemplazan la configuración de usuario.

System_CAPS_pubpropertyVerbs

Obtiene los verbos en tiempo de diseño admitidos por el componente que está asociado al diseñador.

NombreDescripción
System_CAPS_pubmethodDispose()

Libera todos los recursos que usa ComponentDesigner.

System_CAPS_protmethodDispose(Boolean)

Libera los recursos no administrados que usa ComponentDesigner y libera los recursos administrados de forma opcional.

System_CAPS_pubmethodDoDefaultAction()

Crea una firma de método en el archivo de código fuente para el evento predeterminado del componente y desplaza el cursor del usuario a esa ubicación.

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Intenta liberar los recursos mediante una llamada a Dispose(false) antes de que el objeto sea reclamado por la recolección de elementos no utilizados.(Invalida Object.Finalize()).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_protmethodGetService(Type)

Intenta recuperar el tipo de servicio especificado desde el sitio de modo de diseño del componente del diseñador.

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodInitialize(IComponent)

Prepara el diseñador para ver, modificar y diseñar el componente especificado.

System_CAPS_pubmethodInitializeExistingComponent(IDictionary)

Reinicializa un componente existente.

System_CAPS_pubmethodInitializeNewComponent(IDictionary)

Inicializa un componente recién creado.

System_CAPS_pubmethodInitializeNonDefault()

Obsoleto. Inicializa la configuración de un componente importado que ya se ha inicializado la configuración a los valores predeterminados.

System_CAPS_protmethodInvokeGetInheritanceAttribute(ComponentDesigner)

Obtiene el InheritanceAttribute del ComponentDesigner.

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_pubmethodOnSetComponentDefaults()

Obsoleto. Establece las propiedades predeterminadas para el componente.

System_CAPS_protmethodPostFilterAttributes(IDictionary)

Permite que un diseñador cambie o quite elementos del conjunto de atributos que se expone a través de un TypeDescriptor.

System_CAPS_protmethodPostFilterEvents(IDictionary)

Permite que un diseñador cambie o quite elementos del conjunto de eventos que se expone a través de un TypeDescriptor.

System_CAPS_protmethodPostFilterProperties(IDictionary)

Permite que un diseñador cambie o quite elementos del conjunto de propiedades que se expone a través de un TypeDescriptor.

System_CAPS_protmethodPreFilterAttributes(IDictionary)

Permite que un diseñador agregue al conjunto de atributos que se expone a través de un TypeDescriptor.

System_CAPS_protmethodPreFilterEvents(IDictionary)

Permite que un diseñador agregue al conjunto de eventos que se expone a través de un TypeDescriptor.

System_CAPS_protmethodPreFilterProperties(IDictionary)

Permite que un diseñador agregue al conjunto de propiedades que se expone a través de un TypeDescriptor.

System_CAPS_protmethodRaiseComponentChanged(MemberDescriptor, Object, Object)

Notifica a los IComponentChangeService que este componente se ha cambiado.

System_CAPS_protmethodRaiseComponentChanging(MemberDescriptor)

Notifica a los IComponentChangeService que este componente está a punto de cambiarse.

System_CAPS_pubmethodToString()

Devuelve una cadena que representa el objeto actual.(Heredado de Object).

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethodIDesignerFilter.PostFilterAttributes(IDictionary)

Para obtener una descripción de este miembro, vea el método IDesignerFilter.PostFilterAttributes.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDesignerFilter.PostFilterEvents(IDictionary)

Para obtener una descripción de este miembro, vea el método IDesignerFilter.PostFilterEvents.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDesignerFilter.PostFilterProperties(IDictionary)

Para obtener una descripción de este miembro, vea el método IDesignerFilter.PostFilterProperties.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDesignerFilter.PreFilterAttributes(IDictionary)

Para obtener una descripción de este miembro, vea el método IDesignerFilter.PreFilterAttributes.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDesignerFilter.PreFilterEvents(IDictionary)

Para obtener una descripción de este miembro, vea el método IDesignerFilter.PreFilterEvents.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDesignerFilter.PreFilterProperties(IDictionary)

Para obtener una descripción de este miembro, vea el método IDesignerFilter.PreFilterProperties.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyITreeDesigner.Children

Para obtener una descripción de este miembro, vea el ITreeDesigner.Children propiedad.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyITreeDesigner.Parent

Para obtener una descripción de este miembro, vea el ITreeDesigner.Parent propiedad.

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
Disponible desde 1.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: