PanelContainerDesigner Classe

Definizione

Spazio dei nomi:

System.Web.UI.Design.WebControls

Assembly:

System.Design.dll

Fornisce il supporto in fase di progettazione in una finestra di progettazione visiva per il controllo Panel.

public ref class PanelContainerDesigner : System::Web::UI::Design::ContainerControlDesigner

public class PanelContainerDesigner : System.Web.UI.Design.ContainerControlDesigner

type PanelContainerDesigner = class
    inherit ContainerControlDesigner

Public Class PanelContainerDesigner
Inherits ContainerControlDesigner

Ereditarietà

Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

ContainerControlDesigner

PanelContainerDesigner

Esempio

Nell'esempio di codice seguente viene illustrato come estendere la PanelContainerDesigner classe per modificare l'aspetto e il comportamento dei controlli derivati dal Panel controllo in fase di progettazione.

L'esempio deriva la MyPanelContainer classe dal Panel controllo . L'esempio deriva anche la MyPanelContainerDesigner classe dalla PanelContainerDesigner classe e applica un DesignerAttribute attributo per per nella MyPanelContainerDesignerMyPanelContainer classe .

Esegue l'override MyPanelContainerDesigner dei membri seguenti PanelContainerDesigner :

• Proprietà FrameStyle per definire uno stile del bordo in fase di progettazione per il MyPanelContainer controllo .

• Proprietà FrameCaption per fornire una didascalia predefinita per il MyPanelContainer controllo, se non è stata definita alcuna proprietà.

• Metodo Initialize per generare un'eccezione ArgumentException , se il controllo associato non è un MyPanelContainer oggetto .

using System;
using System.Web;
using System.Web.UI.WebControls;
using System.Web.UI.Design.WebControls;
using System.ComponentModel;
using System.Security.Permissions;

namespace Examples.CS.WebControls.Design
{
    // The MyPanelContainer is a copy of the Panel.
    [AspNetHostingPermission(SecurityAction.Demand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, 
        Level = AspNetHostingPermissionLevel.Minimal)]
    [Designer(typeof(Examples.CS.WebControls.Design.MyPanelContainerDesigner))]
    public class MyPanelContainer : Panel
    {
    } // MyPanelContainer

    // Override members of the PanelContainerDesigner.
    public class MyPanelContainerDesigner : PanelContainerDesigner
    {
        // Provide a design-time caption for the panel.
        public override string FrameCaption 
        {
            get
            {
                // If the FrameCaption is empty, use the panel control ID.
                string localCaption = base.FrameCaption;
                if (localCaption == null || localCaption == "")
                    localCaption = ((Panel)Component).ID.ToString();

                return localCaption;
            }
        } // FrameCaption

        // Provide a design-time border style for the panel.
        public override Style FrameStyle
        {
            get
            {
                Style styleOfFrame = base.FrameStyle;

                // If no border style is defined, define one.
                if (styleOfFrame.BorderStyle == BorderStyle.NotSet ||
                    styleOfFrame.BorderStyle == BorderStyle.None)
                    styleOfFrame.BorderStyle = BorderStyle.Outset;

                return styleOfFrame;
            }
        } // FrameStyle

        // Initialize the designer.
        public override void Initialize(IComponent component)
        {
            // Ensure that only a MyPanelContainer can be created 
            // in this designer.
            if (!(component is MyPanelContainer))
                throw new ArgumentException();
            
            base.Initialize(component);
        } // Initialize
    } // MyPanelContainerDesigner
} // Examples.CS.WebControls.Design

Imports System.Web
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design.WebControls
Imports System.ComponentModel
Imports System.Security.Permissions

Namespace Examples.VB.WebControls.Design

    ' The MyPanelContainer is a copy of the PanelContainer.
    <AspNetHostingPermission(SecurityAction.Demand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <Designer(GetType(Examples.VB.WebControls.Design.MyPanelContainerDesigner))> _
    Public Class MyPanelContainer
        Inherits Panel
    End Class

    ' Override members of the PanelContainerDesigner.
    Public Class MyPanelContainerDesigner
        Inherits PanelContainerDesigner

        ' Provide a design-time caption for the panel.
        Public Overrides ReadOnly Property FrameCaption() As String
            Get
                ' If the FrameCaption is empty, use the panel control ID.
                Dim localCaption As String = MyBase.FrameCaption
                If localCaption Is Nothing Or localCaption = "" Then
                    localCaption = CType(Component, Panel).ID.ToString()
                End If

                Return localCaption
            End Get
        End Property ' FrameCaption

        ' Provide a design-time border style for the panel.
        Public Overrides ReadOnly Property FrameStyle() As Style
            Get
                Dim styleOfFrame As Style = MyBase.FrameStyle

                ' If no border style is defined, define one.
                If (styleOfFrame.BorderStyle = BorderStyle.NotSet Or _
                    styleOfFrame.BorderStyle = BorderStyle.None) Then
                    styleOfFrame.BorderStyle = BorderStyle.Outset
                End If

                Return styleOfFrame
            End Get
        End Property ' FrameStyle

        ' Initialize the designer.
        Public Overrides Sub Initialize(ByVal component As IComponent)

            ' Ensure that only a MyPanelContainer can be created   
            ' in this designer. 
            If Not TypeOf component Is MyPanelContainer Then
                Throw New ArgumentException()
            End If

            MyBase.Initialize(component)

        End Sub
    End Class
End Namespace ' Examples.VB.WebControls.Design

Commenti

Il Panel controllo viene usato come contenitore per altri controlli, soprattutto quando i controlli vengono generati a livello di codice.

In una finestra di progettazione visiva, quando si passa dalla visualizzazione Origine a Progettazione, il codice sorgente di markup che descrive il controllo associato Panel viene analizzato e viene creata una versione in fase di progettazione del controllo nell'area di progettazione. Quando si torna alla visualizzazione Origine, il controllo in fase di progettazione viene salvato in modo permanente nel codice sorgente di markup e modificato nel markup per la pagina Web. La PanelContainerDesigner classe fornisce supporto in fase di progettazione per Panel i controlli in una finestra di progettazione visiva.

La FrameCaption proprietà ottiene la didascalia visualizzata nel controllo associato Panel . La FrameStyle proprietà ottiene gli stili del controllo associato.

La UsePreviewControl proprietà restituisce truesempre , che indica che la finestra di progettazione crea una copia temporanea dell'oggetto associato Panel per generare il markup in fase di progettazione.

Il Initialize metodo prepara la finestra di progettazione per visualizzare, modificare e progettare il controllo associato Panel . Il AddDesignTimeCssAttributes metodo imposta gli elementi della raccolta sulle rappresentazioni di stringa di vari attributi di stile del controllo associato.

Costruttori

PanelContainerDesigner()

Inizializza una nuova istanza della classe PanelContainerDesigner.

Proprietà

ActionLists	Ottiene la raccolta dell'elenco di azioni per questa finestra di progettazione controlli. (Ereditato da ControlDesigner)
AllowResize	Ottiene un valore che indica se è possibile ridimensionare il controllo in fase di progettazione. (Ereditato da ContainerControlDesigner)
AssociatedComponents	Ottiene l'insieme dei componenti associati al componente gestito dalla finestra di progettazione. (Ereditato da ComponentDesigner)
AutoFormats	Ottiene la raccolta degli schemi di formattazione automatica predefiniti da visualizzare nella finestra di dialogo Formattazione automatica per il controllo associato in fase di progettazione. (Ereditato da ControlDesigner)
Behavior	Obsoleti. Ottiene o imposta il comportamento DHTML associato alla finestra di progettazione. (Ereditato da HtmlControlDesigner)
Component	Ottiene il componente progettato dalla finestra di progettazione. (Ereditato da ComponentDesigner)
DataBindings	Ottiene l'insieme di associazioni dati per il controllo corrente. (Ereditato da HtmlControlDesigner)
DataBindingsEnabled	Ottiene un valore che indica se l'area contenitore per il controllo controllo associato supporta l'associazione di dati. (Ereditato da ControlDesigner)
DesignerState	Ottiene un oggetto utilizzato per rendere persistenti i dati per il controllo associato in fase di progettazione. (Ereditato da ControlDesigner)
DesignTimeElement	Obsoleti. Ottiene l'oggetto in fase di progettazione che rappresenta il controllo associato all'oggetto HtmlControlDesigner sull'area di progettazione. (Ereditato da HtmlControlDesigner)
DesignTimeElementView	Obsoleti. Ottiene l'oggetto di controllo di visualizzazione per la finestra di progettazione. (Ereditato da ControlDesigner)
DesignTimeHtmlRequiresLoadComplete	Obsoleti. Ottiene un valore che indica se l'host di progettazione deve terminare il caricamento prima di poter chiamare il metodo GetDesignTimeHtml. (Ereditato da ControlDesigner)
Expressions	Ottiene le associazioni di espressioni per il controllo corrente in fase di progettazione. (Ereditato da HtmlControlDesigner)
FrameCaption	Ottiene la didascalia visualizzata nel controllo Panel associato.
FrameStyle	Ottiene gli stili del controllo Panel associato.
HidePropertiesInTemplateMode	Ottiene un valore che indica se le proprietà del controllo associato sono nascoste quando per il controllo è attiva la modalità modello. (Ereditato da ControlDesigner)
ID	Ottiene o imposta a stringa ID per il controllo. (Ereditato da ControlDesigner)
InheritanceAttribute	Ottiene un attributo che indica il tipo di ereditarietà del componente associato. (Ereditato da ComponentDesigner)
Inherited	Ottiene un valore che indica se questo componente è ereditato. (Ereditato da ComponentDesigner)
InTemplateMode	Ottiene un valore che indica se il controllo è in modalità di visualizzazione o modifica del modello in un host di progettazione. La proprietà InTemplateMode è di sola lettura. (Ereditato da ControlDesigner)
IsDirty	Obsoleti. Ottiene o imposta un valore che indica se il controllo server Web è stato contrassegnato come modificato. (Ereditato da ControlDesigner)
NoWrap	Ottiene un valore che specifica se utilizzare l'attributo HTML nowrap sulle tabelle. (Ereditato da ContainerControlDesigner)
ParentComponent	Ottiene il componente padre per la finestra di progettazione. (Ereditato da ComponentDesigner)
ReadOnly	Obsoleti. Ottiene o imposta un valore che indica se le proprietà del controllo sono in sola lettura in fase di progettazione. (Ereditato da ControlDesigner)
RootDesigner	Ottiene la finestra di progettazione di controlli per la pagina del Web Form contenente il controllo associato. (Ereditato da ControlDesigner)
SetTextualDefaultProperty	Fornisce il supporto in fase di progettazione in una finestra di progettazione visiva per il controllo Panel. (Ereditato da ComponentDesigner)
ShadowProperties	Ottiene un insieme di valori di proprietà che eseguono l'override delle impostazioni utente. (Ereditato da ComponentDesigner)
ShouldCodeSerialize	Obsoleti. Ottiene o imposta un valore che indica se durante la serializzazione deve essere creata una dichiarazione di campo per il controllo nel file code-behind, per il documento di progettazione corrente. (Ereditato da HtmlControlDesigner)
Tag	Ottiene un oggetto che rappresenta l'elemento del markup HTML per il controllo associato. (Ereditato da ControlDesigner)
TemplateGroups	Ottiene una raccolta di gruppi di modelli, ognuno contenente una o più definizioni di modello. (Ereditato da ControlDesigner)
UsePreviewControl	Ottiene un valore che indica se la finestra di progettazione deve utilizzare una copia temporanea anziché il controllo effettivo associato a essa per generare il markup Design-Time.
Verbs	Ottiene i verbi in fase di progettazione supportati dal componente associato alla finestra di progettazione. (Ereditato da ComponentDesigner)
ViewControl	Ottiene o imposta un controllo server Web che può essere utilizzato per visualizzare in anteprima il markup HTML Design-Time. (Ereditato da ControlDesigner)
ViewControlCreated	Ottiene o imposta un valore che indica se il controllo View è stato creato per la visualizzazione nell'area di progettazione. (Ereditato da ControlDesigner)
Visible	Ottiene un valore che indica se il controllo è visibile in fase di progettazione. (Ereditato da ControlDesigner)

Metodi

AddDesignTimeCssAttributes(IDictionary)	Aggiunge le rappresentazioni di stringa degli attributi di stile all'insieme da utilizzare per il rendering in fase di progettazione del controllo.
CreateErrorDesignTimeHtml(String)	Crea il markup HTML per visualizzare un messaggio di errore specificato in fase di progettazione. (Ereditato da ControlDesigner)
CreateErrorDesignTimeHtml(String, Exception)	Crea il markup HTML per visualizzare un messaggio di errore di eccezione specificato in fase di progettazione. (Ereditato da ControlDesigner)
CreatePlaceHolderDesignTimeHtml()	Fornisce una rappresentazione del segnaposto rettangolare semplice che visualizza il tipo e l'ID del controllo. (Ereditato da ControlDesigner)
CreatePlaceHolderDesignTimeHtml(String)	Fornisce una rappresentazione del segnaposto rettangolare semplice che visualizza il tipo e l'ID del controllo e le istruzioni o le informazioni aggiuntive specificate. (Ereditato da ControlDesigner)
CreateViewControl()	Restituisce una copia del controllo associato per la visualizzazione o il rendering nell'area di progettazione. (Ereditato da ControlDesigner)
Dispose()	Rilascia tutte le risorse usate da ComponentDesigner. (Ereditato da ComponentDesigner)
Dispose(Boolean)	Rilascia le risorse non gestite usate dall'oggetto HtmlControlDesigner ed eventualmente le risorse gestite. (Ereditato da HtmlControlDesigner)
DoDefaultAction()	Crea una firma di metodo nel file di codice sorgente per l'evento predefinito sul componente e sposta il cursore dell'utente in tale posizione. (Ereditato da ComponentDesigner)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetBounds()	Recupera le coordinate del rettangolo che rappresenta i limiti del controllo come visualizzato nell'area di progettazione. (Ereditato da ControlDesigner)
GetDesignTimeCssAttributes()	Restituisce l'insieme degli attributi di stile per il controllo in fase di progettazione. (Ereditato da ContainerControlDesigner)
GetDesignTimeHtml()	Recupera il markup HTML usato per rappresentare il controllo in fase di progettazione. (Ereditato da ControlDesigner)
GetDesignTimeHtml(DesignerRegionCollection)	Restituisce il markup HTML utilizzato per rappresentare il controllo in fase di progettazione. (Ereditato da ContainerControlDesigner)
GetEditableDesignerRegionContent(EditableDesignerRegion)	Restituisce il contenuto dell'area modificabile del controllo in fase di progettazione. (Ereditato da ContainerControlDesigner)
GetEmptyDesignTimeHtml()	Recupera il markup HTML per rappresentare un controllo server Web in fase di progettazione che non avrà rappresentazione visiva in fase di esecuzione. (Ereditato da ControlDesigner)
GetErrorDesignTimeHtml(Exception)	Recupera il markup HTML che fornisce informazioni sull'eccezione specificata. (Ereditato da ControlDesigner)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetPersistenceContent()	Restituisce il contenuto persistente del controllo al momento della progettazione. (Ereditato da ContainerControlDesigner)
GetPersistInnerHtml()	Obsoleti. Recupera il markup HTML interno persistente del controllo. (Ereditato da ControlDesigner)
GetService(Type)	Esegue un tentativo di recuperare il tipo di servizio specificato dal sito della modalità progettazione del componente della finestra di progettazione. (Ereditato da ComponentDesigner)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
GetViewRendering()	Recupera un oggetto contenente il markup Design-Time per il contenuto e le aree del controllo associato. (Ereditato da ControlDesigner)
Initialize(IComponent)	Prepara la finestra di progettazione per la visualizzazione, la modifica e la progettazione del controllo associato.
InitializeExistingComponent(IDictionary)	Reinizializza un componente esistente. (Ereditato da ComponentDesigner)
InitializeNewComponent(IDictionary)	Inizializza un nuovo componente creato. (Ereditato da ComponentDesigner)
InitializeNonDefault()	Obsoleti. Inizializza le impostazioni relative a un componente importato già inizializzato per impostazioni diverse da quelle predefinite. (Ereditato da ComponentDesigner)
Invalidate()	Invalida l'intera area del controllo visualizzato nell'area di progettazione e comunica alla finestra di progettazione di controlli di ricreare il controllo. (Ereditato da ControlDesigner)
Invalidate(Rectangle)	Invalida l'area specificata del controllo visualizzato nell'area di progettazione e comunica alla finestra di progettazione di controlli di ricreare il controllo. (Ereditato da ControlDesigner)
InvokeGetInheritanceAttribute(ComponentDesigner)	Ottiene l'oggetto InheritanceAttribute dell'oggetto ComponentDesigner specificato. (Ereditato da ComponentDesigner)
IsPropertyBound(String)	Obsoleti. Recupera un valore che indica se la proprietà specificata sul controllo associato prevede l'associazione a dati. (Ereditato da ControlDesigner)
Localize(IDesignTimeResourceWriter)	Utilizza il writer di risorse fornito per rendere persistenti le proprietà localizzate del controllo associato in una risorsa nell'host di progettazione. (Ereditato da ControlDesigner)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnAutoFormatApplied(DesignerAutoFormat)	Chiamato dopo che è stato applicato uno schema di formattazione automatica e predefinito al controllo associato. (Ereditato da ControlDesigner)
OnBehaviorAttached()	Chiamato quando la finestra di progettazione di controlli è collegata a un oggetto Behavior. (Ereditato da ControlDesigner)
OnBehaviorDetaching()	Obsoleti. Chiamato quando viene annullata un'associazione di un comportamento dall'elemento. (Ereditato da HtmlControlDesigner)
OnBindingsCollectionChanged(String)	Obsoleti. Chiamato se viene modificato l'insieme di associazioni dati. (Ereditato da ControlDesigner)
OnClick(DesignerRegionMouseEventArgs)	Chiamato dall'host di progettazione quando l'utente fa clic su un controllo associato in fase di progettazione. (Ereditato da ControlDesigner)
OnComponentChanged(Object, ComponentChangedEventArgs)	Viene chiamato in caso di modifica del controllo associato. (Ereditato da ControlDesigner)
OnComponentChanging(Object, ComponentChangingEventArgs)	Rappresenta il metodo che gestirà l'evento ComponentChanging per il controllo associato. (Ereditato da ControlDesigner)
OnControlResize()	Obsoleti. Chiamato se il controllo server Web associato è stato ridimensionato nell'host di progettazione in fase di progettazione. (Ereditato da ControlDesigner)
OnPaint(PaintEventArgs)	Chiamato se la finestra di progettazione di controlli crea il controllo associato sull'area di progettazione, se il valore CustomPaint è true. (Ereditato da ControlDesigner)
OnSetComponentDefaults()	Obsoleti. Imposta le proprietà predefinite relative al componente. (Ereditato da ComponentDesigner)
OnSetParent()	Fornisce un modo per eseguire un'ulteriore elaborazione quando il controllo associato viene connesso al controllo padre. (Ereditato da HtmlControlDesigner)
PostFilterAttributes(IDictionary)	Consente a una finestra di progettazione di modificare o rimuovere elementi dall'insieme di attributi esposti tramite un oggetto TypeDescriptor. (Ereditato da ComponentDesigner)
PostFilterEvents(IDictionary)	Consente a una finestra di progettazione di modificare o rimuovere elementi dal gruppo di eventi esposti tramite un oggetto TypeDescriptor. (Ereditato da ComponentDesigner)
PostFilterProperties(IDictionary)	Consente a una finestra di progettazione di modificare o rimuovere elementi dall'insieme di proprietà esposte tramite un oggetto TypeDescriptor. (Ereditato da ComponentDesigner)
PreFilterAttributes(IDictionary)	Consente a una finestra di progettazione di aggiungere un insieme di attributi che vengono esposti tramite un oggetto TypeDescriptor. (Ereditato da ComponentDesigner)
PreFilterEvents(IDictionary)	Imposta l'elenco di eventi esposti in fase di progettazione per l'oggetto TypeDescriptor per il componente. (Ereditato da HtmlControlDesigner)
PreFilterProperties(IDictionary)	Aggiunge o rimuove proprietà dalla griglia Proprietà in un host di progettazione in fase di progettazione o fornisce proprietà Design-Time che possono corrispondere alle proprietà sul controllo associato. (Ereditato da ControlDesigner)
RaiseComponentChanged(MemberDescriptor, Object, Object)	Notifica all'oggetto IComponentChangeService che questo componente è stato modificato. (Ereditato da ComponentDesigner)
RaiseComponentChanging(MemberDescriptor)	Notifica all'oggetto IComponentChangeService che questo componente sta per essere modificato. (Ereditato da ComponentDesigner)
RaiseResizeEvent()	Obsoleti. Genera l'evento OnControlResize(). (Ereditato da ControlDesigner)
RegisterClone(Object, Object)	Registra i dati interni in un controllo duplicato. (Ereditato da ControlDesigner)
SetEditableDesignerRegionContent(EditableDesignerRegion, String)	Imposta il contenuto dell'area modificabile del controllo in fase di progettazione. (Ereditato da ContainerControlDesigner)
SetRegionContent(EditableDesignerRegion, String)	Specifica il contenuto per un'area modificabile della visualizzazione Design-Time del controllo. (Ereditato da ControlDesigner)
SetViewFlags(ViewFlags, Boolean)	Assegna l'enumerazione ViewFlags bit per bit specificata al valore del flag specificato. (Ereditato da ControlDesigner)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
UpdateDesignTimeHtml()	Aggiorna il markup HTML Design-Time per il controllo server Web associato mediante la chiamata al metodo GetDesignTimeHtml. (Ereditato da ControlDesigner)

Implementazioni dell'interfaccia esplicita

IDesignerFilter.PostFilterAttributes(IDictionary)	Per una descrizione di questo membro, vedere il metodo PostFilterAttributes(IDictionary). (Ereditato da ComponentDesigner)
IDesignerFilter.PostFilterEvents(IDictionary)	Per una descrizione di questo membro, vedere il metodo PostFilterEvents(IDictionary). (Ereditato da ComponentDesigner)
IDesignerFilter.PostFilterProperties(IDictionary)	Per una descrizione di questo membro, vedere il metodo PostFilterProperties(IDictionary). (Ereditato da ComponentDesigner)
IDesignerFilter.PreFilterAttributes(IDictionary)	Per una descrizione di questo membro, vedere il metodo PreFilterAttributes(IDictionary). (Ereditato da ComponentDesigner)
IDesignerFilter.PreFilterEvents(IDictionary)	Per una descrizione di questo membro, vedere il metodo PreFilterEvents(IDictionary). (Ereditato da ComponentDesigner)
IDesignerFilter.PreFilterProperties(IDictionary)	Per una descrizione di questo membro, vedere il metodo PreFilterProperties(IDictionary). (Ereditato da ComponentDesigner)
ITreeDesigner.Children	Per una descrizione di questo membro, vedere la proprietà Children. (Ereditato da ComponentDesigner)
ITreeDesigner.Parent	Per una descrizione di questo membro, vedere la proprietà Parent. (Ereditato da ComponentDesigner)

Vedi anche

• Panel
• ContainerControlDesigner
• ControlDesigner
• HtmlControlDesigner
• ComponentDesigner
• Introduzione alle finestre di progettazione dei controlli di ASP.NET
• Procedura dettagliata: Creazione di una finestra di progettazione controlli di base per un controllo server Web