Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

ComponentDesigner (Clase)

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

El tipo ComponentDesigner expone los siguientes miembros.

  NombreDescripción
Método públicoComponentDesignerInicializa una nueva instancia de la clase ComponentDesigner.
Arriba

  NombreDescripción
Propiedad públicaActionListsObtiene las listas de acciones en tiempo de diseño que admite el componente asociado al diseñador.
Propiedad públicaAssociatedComponentsObtiene la colección de componentes asociados al componente administrado por el diseñador.
Propiedad públicaComponentObtiene el componente que el diseñador está creando.
Propiedad protegidaInheritanceAttributeObtiene un atributo que indica el tipo de herencia del componente asociado.
Propiedad protegidaInheritedObtiene un valor que indica si este componente es heredado.
Propiedad protegidaParentComponentObtiene el componente primario de este diseñador.
Propiedad protegidaShadowPropertiesObtiene una colección de valores de propiedad que reemplazan la configuración del usuario.
Propiedad públicaVerbsObtiene los verbos en tiempo de diseño que admite el componente asociado al diseñador.
Arriba

  NombreDescripción
Método públicoDispose()Libera todos los recursos utilizados por ComponentDesigner.
Método protegidoDispose(Boolean)Libera los recursos no administrados que utiliza ComponentDesigner y libera los recursos administrados de forma opcional.
Método públicoDoDefaultActionCrea una firma de método en el archivo de código fuente para el evento predeterminado del componente y hace navegar el cursor del usuario en esa ubicación.
Método públicoEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método protegidoFinalizeIntenta 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 a Object.Finalize()).
Método públicoGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método protegidoGetServiceIntenta recuperar el tipo de servicio especificado del sitio en modo de diseño del componente del diseñador.
Método públicoGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método públicoInitializePrepara el diseñador para ver, modificar y diseñar el componente especificado.
Método públicoInitializeExistingComponentReinicializa un componente existente.
Método públicoInitializeNewComponentInicializa un componente recién creado.
Método públicoInitializeNonDefault Obsoleta. Inicializa la configuración de un componente importado que ya se ha inicializado con una configuración que no es la predeterminada.
Método protegidoInvokeGetInheritanceAttributeObtiene el objeto InheritanceAttribute de la enumeración ComponentDesigner especificada.
Método protegidoMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método públicoOnSetComponentDefaults Obsoleta. Establece las propiedades predeterminadas del componente.
Método protegidoPostFilterAttributesPermite a un diseñador cambiar o quitar elementos en el conjunto de atributos que expone mediante un TypeDescriptor.
Método protegidoPostFilterEventsPermite a un diseñador cambiar o quitar elementos del conjunto de eventos que expone mediante un objeto TypeDescriptor.
Método protegidoPostFilterPropertiesPermite a un diseñador cambiar o quitar elementos del conjunto de propiedades que expone mediante un objeto TypeDescriptor.
Método protegidoPreFilterAttributesPermite a un diseñador agregar elementos al conjunto de atributos que expone mediante un objeto TypeDescriptor.
Método protegidoPreFilterEventsPermite a un diseñador agregar elementos al conjunto de eventos que expone mediante un objeto TypeDescriptor.
Método protegidoPreFilterPropertiesPermite a un diseñador agregar elementos al conjunto de propiedades que expone mediante un objeto TypeDescriptor.
Método protegidoRaiseComponentChangedNotifica a IComponentChangeService que este componente se ha cambiado.
Método protegidoRaiseComponentChangingNotifica a IComponentChangeService que este componente se va a cambiar.
Método públicoToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Arriba

  NombreDescripción
Implementación explícita de interfacesMétodo privadoIDesignerFilter.PostFilterAttributesPara obtener una descripción de este miembro, vea el método IDesignerFilter.PostFilterAttributes.
Implementación explícita de interfacesMétodo privadoIDesignerFilter.PostFilterEventsPara obtener una descripción de este miembro, vea el método IDesignerFilter.PostFilterEvents.
Implementación explícita de interfacesMétodo privadoIDesignerFilter.PostFilterPropertiesPara obtener una descripción de este miembro, vea el método IDesignerFilter.PostFilterProperties.
Implementación explícita de interfacesMétodo privadoIDesignerFilter.PreFilterAttributesPara obtener una descripción de este miembro, vea el método IDesignerFilter.PreFilterAttributes.
Implementación explícita de interfacesMétodo privadoIDesignerFilter.PreFilterEventsPara obtener una descripción de este miembro, vea el método IDesignerFilter.PreFilterEvents.
Implementación explícita de interfacesMétodo privadoIDesignerFilter.PreFilterPropertiesPara obtener una descripción de este miembro, vea el método IDesignerFilter.PreFilterProperties.
Implementación explícita de interfacesPropiedad privadaITreeDesigner.ChildrenPara obtener una descripción de este miembro, vea la propiedad ITreeDesigner.Children.
Implementación explícita de interfacesPropiedad privadaITreeDesigner.ParentPara obtener una descripción de este miembro, vea la propiedad ITreeDesigner.Parent.
Arriba

La clase del diseñador base ComponentDesigner proporciona un diseñador sencillo que puede extender el comportamiento de un componente asociado en modo de diseño.

ComponentDesigner proporciona una implementación vacía de la interfaz IDesignerFilter, cuyos métodos se pueden reemplazar para ajustar los atributos, propiedades y eventos del componente asociado en tiempo de diseño.

Se puede asociar un diseñador a un tipo mediante DesignerAttribute. Para obtener información general sobre la personalización del comportamiento en tiempo de diseño, vea Ampliar compatibilidad en tiempo de diseño.

La clase ComponentDesigner implementa un comportamiento especial para los descriptores de propiedades de componentes heredados. La implementación de ComponentDesigner predeterminada usa un tipo interno denominado InheritedPropertyDescriptor para sustituir propiedades heredadas de una clase base. Hay dos casos en los que se agregan estos descriptores de propiedades.

  1. Al propio objeto raíz devuelto por la propiedad IDesignerHost.RootComponent, porque se hereda de su clase base.

  2. A los campos situados en la clase base del objeto raíz. Los campos públicos y protegidos de la clase base se agregan al diseñador para que el usuario pueda manipularlos.

La clase InheritedPropertyDescriptor modifica el valor predeterminado de una propiedad, de modo que el valor predeterminado sea el valor actual en el momento de creación de instancias de un objeto. Esto se debe a que la propiedad se hereda de otra instancia. El diseñador define el restablecimiento del valor de propiedad como su establecimiento en el valor establecido por la clase heredada. Este valor puede diferir del valor predeterminado almacenado en los metadatos.

En el ejemplo de código siguiente se proporciona una implementación de ComponentDesigner de ejemplo y un componente de ejemplo asociado al diseñador. El diseñador reemplaza el método Initialize que llama al método base Initialize, reemplaza el método DoDefaultAction que muestra MessageBox cuando se hace doble clic en el componente y reemplaza el descriptor de acceso de la propiedad Verbs que proporciona un comando de menú DesignerVerb personalizado para el menú contextual del componente.


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

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft