Exportar (0) Imprimir
Expandir todo
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original

ContainerControlDesigner (Clase)

Proporciona funciones del diseñador para controles que contienen controles secundarios o propiedades que se pueden modificar en tiempo de diseño.

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

[SecurityPermissionAttribute(SecurityAction.Demand, Flags = SecurityPermissionFlag.UnmanagedCode)]
public class ContainerControlDesigner : ControlDesigner

El tipo ContainerControlDesigner expone los siguientes miembros.

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

  NombreDescripción
Propiedad públicaActionListsObtiene la colección de lista de acciones para el diseñador de controles. (Se hereda de ControlDesigner).
Propiedad públicaAllowResizeObtiene un valor que indica si se puede cambiar el tamaño del control en tiempo de diseño. (Invalida a ControlDesigner.AllowResize).
Propiedad públicaAssociatedComponentsObtiene la colección de componentes asociados al componente administrado por el diseñador. (Se hereda de ComponentDesigner).
Propiedad públicaAutoFormatsObtiene la colección de esquemas de formato automático predefinidos que se debe mostrar en el cuadro de diálogo Formato automático del control asociado en tiempo de diseño. (Se hereda de ControlDesigner).
Propiedad públicaBehavior Obsoleto. Obtiene o establece el comportamiento DHTML asociado al diseñador. (Se hereda de HtmlControlDesigner).
Propiedad públicaComponentObtiene el componente que el diseñador está creando. (Se hereda de ComponentDesigner).
Propiedad públicaDataBindingsObtiene la colección de enlaces de datos del control actual. (Se hereda de HtmlControlDesigner).
Propiedad protegidaDataBindingsEnabledObtiene un valor que indica si la región contenedora del control asociado permite el enlace a datos. (Se hereda de ControlDesigner).
Propiedad protegidaDesignerStateObtiene un objeto que se utiliza para guardar los datos del control asociado en tiempo de diseño. (Se hereda de ControlDesigner).
Propiedad protegidaDesignTimeElement Obsoleto. Obtiene el objeto en tiempo de diseño que representa el control asociado al objeto HtmlControlDesigner en la superficie de diseño. (Se hereda de HtmlControlDesigner).
Propiedad protegidaDesignTimeElementView Obsoleto. Obtiene el objeto de control de vista para el diseñador de controles. (Se hereda de ControlDesigner).
Propiedad públicaDesignTimeHtmlRequiresLoadComplete Obsoleto. Obtiene un valor que indica si el host de diseño debe terminar de cargarse antes de que se pueda llamar al método GetDesignTimeHtml. (Se hereda de ControlDesigner).
Propiedad públicaExpressionsObtiene los enlaces de expresión en tiempo de diseño para el control actual. (Se hereda de HtmlControlDesigner).
Propiedad públicaFrameCaptionObtiene el título que se mostrará para un control en tiempo de diseño.
Propiedad públicaFrameStyleObtiene el estilo que se aplica al marco del control en tiempo de diseño.
Propiedad protegidaHidePropertiesInTemplateModeInfraestructura. Obtiene un valor que indica si las propiedades del control asociado están ocultas cuando el control está en modo de plantilla. (Se hereda de ControlDesigner).
Propiedad públicaIDObtiene o establece la cadena del identificador del control. (Se hereda de ControlDesigner).
Propiedad protegidaInheritanceAttributeObtiene un atributo que indica el tipo de herencia del componente asociado. (Se hereda de ComponentDesigner).
Propiedad protegidaInheritedObtiene un valor que indica si este componente es heredado. (Se hereda de ComponentDesigner).
Propiedad protegidaInTemplateModeObtiene un valor que indica si el control está en el modo de vista o de edición de plantilla en el host de diseño. La propiedad InTemplateMode es de sólo lectura. (Se hereda de ControlDesigner).
Propiedad públicaIsDirty Obsoleto. Obtiene o establece un valor que indica si el control de servidor Web se ha marcado como modificado. (Se hereda de ControlDesigner).
Propiedad protegidaParentComponentObtiene el componente primario de este diseñador. (Se hereda de ComponentDesigner).
Propiedad públicaReadOnly Obsoleto. Obtiene o establece un valor que indica si las propiedades del control son de sólo lectura en tiempo de diseño. (Se hereda de ControlDesigner).
Propiedad protegidaRootDesignerObtiene el diseñador de controles para la página de formularios Web Forms que contiene el control asociado. (Se hereda de ControlDesigner).
Propiedad protegidaShadowPropertiesObtiene una colección de valores de propiedad que reemplazan la configuración del usuario. (Se hereda de ComponentDesigner).
Propiedad públicaShouldCodeSerialize Obsoleto. Obtiene o establece un valor que indica si se debe crear una declaración de campo para el control en el archivo de código subyacente para el documento de diseño actual durante la serialización. (Se hereda de HtmlControlDesigner).
Propiedad protegidaTagObtiene un objeto que representa el elemento de formato HTML del control asociado. (Se hereda de ControlDesigner).
Propiedad públicaTemplateGroupsObtiene una colección de grupos de plantillas, en cada uno de los cuales hay una o varias definiciones de plantilla (Se hereda de ControlDesigner).
Propiedad protegidaUsePreviewControlObtiene un valor que indica si el diseñador de controles utiliza un control de vista previa temporal para generar el formato HTML en tiempo de diseño. (Se hereda de ControlDesigner).
Propiedad públicaVerbsObtiene los verbos en tiempo de diseño que admite el componente asociado al diseñador. (Se hereda de ComponentDesigner).
Propiedad públicaViewControlObtiene o establece un control de servidor Web que se puede utilizar para ofrecer una vista previa del formato HTML en tiempo de diseño. (Se hereda de ControlDesigner).
Propiedad públicaViewControlCreatedObtiene o establece un valor que indica si se ha creado un control View para la presentación en la superficie de diseño. (Se hereda de ControlDesigner).
Propiedad protegidaVisibleObtiene un valor que indica si el control está visible en tiempo de diseño. (Se hereda de ControlDesigner).
Arriba

  NombreDescripción
Método protegidoAddDesignTimeCssAttributesAgrega los atributos de estilo del control en tiempo de diseño.
Método protegidoCreateErrorDesignTimeHtml(String)Crea el formato HTML para mostrar un mensaje de error especificado en tiempo de diseño. (Se hereda de ControlDesigner).
Método protegidoCreateErrorDesignTimeHtml(String, Exception)Crea el formato HTML para mostrar un mensaje de error de excepción especificado en tiempo de diseño. (Se hereda de ControlDesigner).
Método protegidoCreatePlaceHolderDesignTimeHtml()Proporciona una representación sencilla del marcador de posición rectangular que muestra el tipo y el Id. del control. (Se hereda de ControlDesigner).
Método protegidoCreatePlaceHolderDesignTimeHtml(String)Proporciona una representación sencilla del marcador de posición rectangular que muestra el tipo y el Id. del control, así como instrucciones o información adicionales que se hayan especificado. (Se hereda de ControlDesigner).
Método protegidoCreateViewControlDevuelve una copia del control asociado para verlo o representarlo en la superficie de diseño. (Se hereda de ControlDesigner).
Método públicoDispose()Libera todos los recursos utilizados por el objeto ComponentDesigner. (Se hereda de ComponentDesigner).
Método protegidoDispose(Boolean)Libera los recursos no administrados utilizados por el objeto HtmlControlDesigner y, de forma opcional, libera los recursos administrados. (Se hereda de HtmlControlDesigner).
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. (Se hereda de ComponentDesigner).
Método públicoEquals(Object)Determina si el objeto Object especificado es igual al objeto Object 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 el recolector de objetos no utilizados. (Se hereda de ComponentDesigner).
Método públicoGetBoundsRecupera las coordenadas del rectángulo que representa los límites del control mostrado en la superficie de diseño. (Se hereda de ControlDesigner).
Método públicoGetDesignTimeCssAttributesDevuelve los atributos de estilo de la colección en tiempo de diseño.
Método públicoGetDesignTimeHtml()Recupera el formato HTML que se usa para representar el control en tiempo de diseño. (Se hereda de ControlDesigner).
Método públicoGetDesignTimeHtml(DesignerRegionCollection)Infraestructura. Devuelve el formato HTML usado para representar el control en tiempo de diseño. (Invalida a ControlDesigner.GetDesignTimeHtml(DesignerRegionCollection)).
Método públicoGetEditableDesignerRegionContentDevuelve el contenido de la región modificable del control en tiempo de diseño. (Invalida a ControlDesigner.GetEditableDesignerRegionContent(EditableDesignerRegion)).
Método protegidoGetEmptyDesignTimeHtmlRecupera el formato HTML para representar un control de servidor Web en tiempo de diseño que no tendrá ninguna representación visual en tiempo de ejecución. (Se hereda de ControlDesigner).
Método protegidoGetErrorDesignTimeHtmlRecupera el formato HTML que proporciona información sobre la excepción especificada. (Se hereda de ControlDesigner).
Método públicoGetHashCodeActúa como función hash para un tipo concreto. (Se hereda de Object).
Método públicoGetPersistenceContentDevuelve el contenido con persistencia del control en tiempo de diseño. (Invalida a ControlDesigner.GetPersistenceContent()).
Método públicoGetPersistInnerHtml Obsoleto. Recupera el formato HTML interno con persistencia del control. (Se hereda de ControlDesigner).
Método protegidoGetServiceIntenta recuperar el tipo de servicio especificado del sitio en modo de diseño del componente del diseñador. (Se hereda de ComponentDesigner).
Método públicoGetType Obtiene el Typede la instancia actual. (Se hereda de Object).
Método públicoGetViewRendering()Recupera un objeto que contiene el formato en tiempo de diseño para el contenido y las regiones del control asociado. (Se hereda de ControlDesigner).
Método públicoInitializeInicializa el diseñador de controles y carga el componente especificado. (Se hereda de ControlDesigner).
Método públicoInitializeExistingComponentReinicializa un componente existente. (Se hereda de ComponentDesigner).
Método públicoInitializeNewComponentInicializa un componente recién creado. (Se hereda de ComponentDesigner).
Método públicoInitializeNonDefault Obsoleto. Inicializa la configuración de un componente importado que ya se ha inicializado con una configuración que no es la predeterminada. (Se hereda de ComponentDesigner).
Método públicoInvalidate()Invalida todo el área del control que se muestra en la superficie de diseño y señala al diseñador de controles que vuelva a dibujar el control. (Se hereda de ControlDesigner).
Método públicoInvalidate(Rectangle)Invalida el área especificada del control que se muestra en la superficie de diseño y señala al diseñador de controles que vuelva a dibujar el control. (Se hereda de ControlDesigner).
Método protegidoInvokeGetInheritanceAttributeObtiene el objeto InheritanceAttribute de la enumeración ComponentDesigner especificada. (Se hereda de ComponentDesigner).
Método públicoIsPropertyBound Obsoleto. Recupera un valor que indica si la propiedad especificada en el control asociado está enlazada a datos o no. (Se hereda de ControlDesigner).
Método públicoLocalizeUtiliza el sistema de escritura de recursos proporcionado para conservar las propiedades adaptables del control asociado en un recurso en el host de diseño. (Se hereda de ControlDesigner).
Método protegidoMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método públicoOnAutoFormatAppliedSe le llama cuando se ha aplicado un esquema de formato automático predefinido al control asociado. (Se hereda de ControlDesigner).
Método protegidoOnBehaviorAttached Obsoleto. Se le llama cuando un comportamiento está asociado al elemento. (Se hereda de HtmlControlDesigner).
Método protegidoOnBehaviorDetaching Obsoleto. Se le llama cuando se anula la asociación de un comportamiento al elemento. (Se hereda de HtmlControlDesigner).
Método protegidoOnBindingsCollectionChanged Obsoleto. Se le llama cuando cambia la colección de enlace a datos. (Se hereda de ControlDesigner).
Método protegidoOnClickLo llama el host de diseño cuando el usuario hace clic en el control asociado en tiempo de diseño. (Se hereda de ControlDesigner).
Método públicoOnComponentChangedSe le llama cuando cambia el control asociado. (Se hereda de ControlDesigner).
Método públicoOnComponentChangingRepresenta el método que controlará el evento ComponentChanging del control asociado. (Se hereda de ControlDesigner).
Método protegidoOnControlResize Obsoleto. Se le llama cuando el control de servidor Web asociado ha cambiado de tamaño en tiempo de diseño en el host de diseño. (Se hereda de ControlDesigner).
Método protegidoOnPaintSe le llama cuando el diseñador de controles dibuja el control asociado en la superficie de diseño, si el valor CustomPaint es true. (Se hereda de ControlDesigner).
Método públicoOnSetComponentDefaults Obsoleto. Establece las propiedades predeterminadas del componente. (Se hereda de ComponentDesigner).
Método públicoOnSetParentProporciona una manera de realizar el procesamiento adicional cuando el control asociado se asocia a un control primario. (Se hereda de HtmlControlDesigner).
Método protegidoPostFilterAttributesPermite a un diseñador cambiar o quitar elementos en el conjunto de atributos que expone mediante un TypeDescriptor. (Se hereda de ComponentDesigner).
Método protegidoPostFilterEventsPermite a un diseñador cambiar o quitar elementos del conjunto de eventos que expone mediante un objeto TypeDescriptor. (Se hereda de ComponentDesigner).
Método protegidoPostFilterPropertiesPermite a un diseñador cambiar o quitar elementos del conjunto de propiedades que expone mediante un objeto TypeDescriptor. (Se hereda de ComponentDesigner).
Método protegidoPreFilterAttributesPermite a un diseñador agregar elementos al conjunto de atributos que expone mediante un objeto TypeDescriptor. (Se hereda de ComponentDesigner).
Método protegidoPreFilterEventsEstablece la lista de eventos que se exponen en tiempo de diseño para el objeto TypeDescriptor para el componente. (Se hereda de HtmlControlDesigner).
Método protegidoPreFilterPropertiesAgrega propiedades o quita propiedades de la cuadrícula Propiedades en un host de diseño en tiempo de diseño, o proporciona nuevas propiedades en tiempo de diseño que pueden corresponderse con las propiedades del control asociado. (Se hereda de ControlDesigner).
Método protegidoRaiseComponentChangedNotifica a IComponentChangeService que este componente se ha cambiado. (Se hereda de ComponentDesigner).
Método protegidoRaiseComponentChangingNotifica a IComponentChangeService que este componente se va a cambiar. (Se hereda de ComponentDesigner).
Método públicoRaiseResizeEvent Obsoleto. Provoca el evento OnControlResize. (Se hereda de ControlDesigner).
Método públicoRegisterCloneRegistra los datos internos en un control clonado. (Se hereda de ControlDesigner).
Método públicoSetEditableDesignerRegionContentEstablece el contenido de la región modificable del control en tiempo de diseño. (Invalida a ControlDesigner.SetEditableDesignerRegionContent(EditableDesignerRegion, String)).
Método protegidoSetRegionContentEspecifica el contenido de una región modificable en la vista en tiempo de diseño del control. (Se hereda de ControlDesigner).
Método protegidoSetViewFlagsAsigna la enumeración ViewFlags bit a bit especificada al valor de marcador especificado. (Se hereda de ControlDesigner).
Método públicoToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Método públicoUpdateDesignTimeHtmlActualiza el formato HTML en tiempo de diseño para el control de servidor Web asociado llamando al método GetDesignTimeHtml. (Se hereda de ControlDesigner).
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. (Se hereda de ComponentDesigner).
Implementación explícita de interfacesMétodo privadoIDesignerFilter.PostFilterEventsPara obtener una descripción de este miembro, vea el método IDesignerFilter.PostFilterEvents. (Se hereda de ComponentDesigner).
Implementación explícita de interfacesMétodo privadoIDesignerFilter.PostFilterPropertiesPara obtener una descripción de este miembro, vea el método IDesignerFilter.PostFilterProperties. (Se hereda de ComponentDesigner).
Implementación explícita de interfacesMétodo privadoIDesignerFilter.PreFilterAttributesPara obtener una descripción de este miembro, vea el método IDesignerFilter.PreFilterAttributes. (Se hereda de ComponentDesigner).
Implementación explícita de interfacesMétodo privadoIDesignerFilter.PreFilterEventsPara obtener una descripción de este miembro, vea el método IDesignerFilter.PreFilterEvents. (Se hereda de ComponentDesigner).
Implementación explícita de interfacesMétodo privadoIDesignerFilter.PreFilterPropertiesPara obtener una descripción de este miembro, vea el método IDesignerFilter.PreFilterProperties. (Se hereda de ComponentDesigner).
Implementación explícita de interfacesPropiedad privadaITreeDesigner.ChildrenPara obtener una descripción de este miembro, vea la propiedad ITreeDesigner.Children. (Se hereda de ComponentDesigner).
Implementación explícita de interfacesPropiedad privadaITreeDesigner.ParentPara obtener una descripción de este miembro, vea la propiedad ITreeDesigner.Parent. (Se hereda de ComponentDesigner).
Arriba

La clase ContainerControlDesigner proporciona una clase base de diseñador para controles que pueden modificarse en la superficie de diseño. Se incluyen los controles con controles secundarios o propiedades internas modificables. La clase ContainerControlDesigner proporciona una sola región con marco para representar el control y controla automáticamente la representación del control en tiempo de diseño.

Aplique el atributo ParseChildrenAttribute en el control asociado para determinar el comportamiento en tiempo de diseño de la clase ContainerControlDesigner. Aplique los valores del atributo ParseChildrenAttribute en el control asociado como se detalla a continuación:

  • false para indicar que ContainerControlDesigner representa el contenido de la región del diseño modificable como controles secundarios.

  • true para indicar que ContainerControlDesigner representa el contenido de la región del diseño modificable como propiedades internas modificables del control.

Los desarrolladores de controles pueden derivar y ampliar un diseñador personalizado a partir de uno de los diseñadores base, en función del tipo de control que se esté diseñando, como se describe en la siguiente lista:

  • Los controles a los que se puede agregar controles secundarios en tiempo de diseño se pueden derivar de la clase ContainerControlDesigner. Por ejemplo, la clase PanelContainerDesigner se deriva de la clase ContainerControlDesigner y representa un control Panel en la superficie de diseño.

  • Los controles que tienen controles secundarios, y pueden tener también una región de diseñador modificable en la que se pueden agregar controles en tiempo de diseño, se pueden derivar de la clase CompositeControlDesigner.

  • Los controles que requieren un procesamiento personalizado en tiempo de diseño se pueden derivar de la clase base ControlDesigner.

NotaNota

La clase ContainerControlDesigner sustituye a la clase ReadWriteControlDesigner obsoleta.

Utilice el atributo DesignerAttribute para asociar una clase de diseñador personalizada junto con una implementación de control. Para obtener más información sobre cómo utilizar los diseñadores de controles con controles personalizados, vea Tutorial: Crear un diseñador de controles básico para un control de servidor web.

En el ejemplo de código siguiente se muestra cómo derivar una clase de diseñador de la clase ContainerControlDesigner. El ejemplo define un solo control que se deriva de la clase CompositeControl y que define un diseñador asociado, que se deriva de la clase ContainerControlDesigner. La clase de diseñador derivado reemplaza las propiedades FrameCaption y FrameStyle para personalizar el marco que está alrededor de la región modificable del control en la superficie de diseño.


using System;
using System.ComponentModel;
using System.ComponentModel.Design;
using System.Drawing;
using System.Web.UI;
using System.Web.UI.Design;
using System.Web.UI.Design.WebControls;
using System.Web.UI.WebControls;

namespace ControlDesignerSamples.CS
{

    // Define a simple composite control, derived from the 
    // System.Web.UI.WebControls.CompositeControl class.
    [
        Designer(typeof(SimpleContainerControlDesigner)) , 
        ParseChildren(false)
    ]
    public class SimpleContainerControl : CompositeControl
    {
    }


    // Define the designer for the simple composite control.
    // The designer derives from System.Web.UI.Design.ContainerControlDesigner.
    // The designer defines the style and caption for frame around the 
    // editable region in the design surface.
    public class SimpleContainerControlDesigner : ContainerControlDesigner
    {
        private Style _style = null;

        // Define the caption text for the frame in the design surface.
        public override string FrameCaption
        {
            get
            {
                return "= My simple container control =";
            }
        }

        // Define the style of the frame around the control in the design surface.
        public override Style FrameStyle
        {
            get
            {
                if (_style == null)
                {
                    _style = new Style();
                    _style.Font.Name = "Verdana";
                    _style.Font.Size = new FontUnit("XSmall");
                    _style.BackColor = Color.LavenderBlush;
                    _style.ForeColor = Color.DarkBlue;
                }

                return _style;
            }
        }
    }
}


.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.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