ContainerControlDesigner Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce funzionalità di progettazione per i controlli che contengono controlli figlio o proprietà che possono essere modificati in fase di progettazione.
public ref class ContainerControlDesigner : System::Web::UI::Design::ControlDesignerpublic class ContainerControlDesigner : System.Web.UI.Design.ControlDesignertype ContainerControlDesigner = class
inherit ControlDesignerPublic Class ContainerControlDesigner
Inherits ControlDesigner- Ereditarietà
- Derivato
Esempio
Nell'esempio di codice seguente viene illustrato come derivare una classe di ContainerControlDesigner progettazione dalla classe . L'esempio definisce un controllo semplice derivato dalla CompositeControl classe e quindi definisce una finestra di progettazione associata, derivata dalla ContainerControlDesigner classe . La classe della finestra di progettazione derivata esegue l'override delle FrameCaption proprietà e FrameStyle per personalizzare il frame intorno all'area modificabile del controllo nell'area di progettazione.
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;
}
}
}
}
Imports System.ComponentModel
Imports System.ComponentModel.Design
Imports System.Collections
Imports System.Drawing
Imports System.Web.UI
Imports System.Web.UI.Design
Imports System.Web.UI.Design.WebControls
Imports System.Web.UI.WebControls
Namespace ControlDesignerSamples.VB
' Define a simple composite control, derived from the
' System.Web.UI.WebControls.CompositeControl class.
<Designer(GetType(SimpleContainerControlDesigner)), _
ParseChildren(False)> _
Public Class SimpleContainerControl
Inherits CompositeControl
End Class
' 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 the frame around the
' editable region of the control in the design surface.
Public Class SimpleContainerControlDesigner
Inherits ContainerControlDesigner
Private _style As Style = Nothing
' Define the caption text for the frame in the design surface.
Public Overrides ReadOnly Property FrameCaption() As String
Get
Return "- My simple container control -"
End Get
End Property
' Define the style of the frame around the control in the design surface.
Public Overrides ReadOnly Property FrameStyle() As Style
Get
If _style Is Nothing Then
_style = New Style()
_style.Font.Name = "Verdana"
_style.Font.Size = New FontUnit("XSmall")
_style.BackColor = Color.LavenderBlush
_style.ForeColor = Color.DarkBlue
End If
Return _style
End Get
End Property
End Class
End Namespace
Commenti
La ContainerControlDesigner classe fornisce una classe di progettazione di base per i controlli che possono essere modificati nell'area di progettazione. Sono inclusi i controlli che contengono controlli figlio o proprietà interne modificabili. ContainerControlDesigner fornisce una singola area incorniciata per rappresentare il controllo e gestisce automaticamente il rendering del controllo in fase di progettazione.
Applicare l'attributo ParseChildrenAttribute al controllo associato per determinare il comportamento in fase di progettazione dell'oggetto ContainerControlDesigner. Applicare le ParseChildrenAttribute impostazioni nel controllo associato come indicato di seguito:
falseper indicare che ContainerControlDesigner rappresenta il contenuto dell'area di progettazione modificabile come controlli figlio.trueper indicare che ContainerControlDesigner rappresenta il contenuto dell'area di progettazione modificabile come proprietà interne modificabili del controllo.
Gli sviluppatori di controlli possono derivare ed estendere una finestra di progettazione personalizzata da una delle diverse finestre di progettazione di base a seconda del tipo di controllo in fase di sviluppo, come definito nell'elenco seguente:
I controlli che consentono l'aggiunta di controlli figlio in fase di progettazione possono derivare dalla ContainerControlDesigner classe . Ad esempio, la PanelContainerDesigner classe è derivata dalla ContainerControlDesigner classe e rappresenta un Panel controllo nell'area di progettazione.
I controlli con uno o più controlli figlio e possono avere anche un'area di progettazione modificabile in cui i controlli possono essere aggiunti in fase di progettazione, possono derivare dalla CompositeControlDesigner classe .
I controlli che richiedono l'elaborazione personalizzata in fase di progettazione possono derivare dalla classe di base ControlDesigner .
Note
La ContainerControlDesigner classe sostituisce la classe obsoleta ReadWriteControlDesigner .
Usare l'attributo DesignerAttribute per associare una classe di progettazione personalizzata a un'implementazione del controllo personalizzato. Per informazioni dettagliate su come usare finestre di progettazione controlli con controlli personalizzati, vedere Procedura dettagliata: Creazione di una finestra di progettazione controlli di base per un controllo server Web.
Costruttori
| Nome | Descrizione |
|---|---|
| ContainerControlDesigner() |
Inizializza una nuova istanza della classe ContainerControlDesigner. |
Proprietà
| Nome | Descrizione |
|---|---|
| ActionLists |
Ottiene la raccolta di elenchi di azioni per la finestra di progettazione dei controlli. (Ereditato da ControlDesigner) |
| AllowResize |
Ottiene un valore che indica se il controllo può essere ridimensionato in fase di progettazione. |
| AssociatedComponents |
Ottiene la raccolta di componenti associati al componente gestito dalla finestra di progettazione. (Ereditato da ComponentDesigner) |
| AutoFormats |
Ottiene l'insieme di schemi di formattazione automatica predefiniti da visualizzare nella finestra di dialogo Formato automatico 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 che la finestra di progettazione sta progettando. (Ereditato da ComponentDesigner) |
| DataBindings |
Ottiene la raccolta di data binding per il controllo corrente. (Ereditato da HtmlControlDesigner) |
| DataBindingsEnabled |
Ottiene un valore che indica se il data binding è supportato dall'area contenitore per il controllo associato. (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 nell'area HtmlControlDesigner di progettazione. (Ereditato da HtmlControlDesigner) |
| DesignTimeElementView |
Obsoleti.
Ottiene l'oggetto view-control per la finestra di progettazione dei controlli. (Ereditato da ControlDesigner) |
| DesignTimeHtmlRequiresLoadComplete |
Obsoleti.
Ottiene un valore che indica se l'host di progettazione deve completare il caricamento prima che il GetDesignTimeHtml metodo possa essere chiamato. (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 per un controllo in fase di progettazione. |
| FrameStyle |
Ottiene lo stile applicato alla cornice di controllo in fase di progettazione. |
| HidePropertiesInTemplateMode |
Ottiene un valore che indica se le proprietà del controllo associato sono nascoste quando il controllo è in modalità modello. (Ereditato da ControlDesigner) |
| ID |
Ottiene o imposta la 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 il componente è ereditato. (Ereditato da ComponentDesigner) |
| InTemplateMode |
Ottiene un valore che indica se il controllo è in modalità di visualizzazione o modifica di modelli nell'host di progettazione. La InTemplateMode proprietà è 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 |
| ParentComponent |
Ottiene il componente padre per questa finestra di progettazione. (Ereditato da ComponentDesigner) |
| ReadOnly |
Obsoleti.
Ottiene o imposta un valore che indica se le proprietà del controllo sono di sola lettura in fase di progettazione. (Ereditato da ControlDesigner) |
| RootDesigner |
Ottiene la finestra di progettazione controlli per la pagina Web Form che contiene il controllo associato. (Ereditato da ControlDesigner) |
| ShadowProperties |
Ottiene una raccolta di valori di proprietà che eseguono l'override delle impostazioni utente. (Ereditato da ComponentDesigner) |
| ShouldCodeSerialize |
Obsoleti.
Ottiene o imposta un valore che indica se creare una dichiarazione di campo per il controllo nel file code-behind per il documento di progettazione corrente durante la serializzazione. (Ereditato da HtmlControlDesigner) |
| Tag |
Ottiene un oggetto che rappresenta l'elemento di 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 dei controlli utilizza un controllo di anteprima temporaneo per generare il markup HTML in fase di progettazione. (Ereditato da ControlDesigner) |
| Verbs |
Ottiene i verbi della 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 in fase di progettazione. (Ereditato da ControlDesigner) |
| ViewControlCreated |
Ottiene o imposta un valore che indica se è stato creato un |
| Visible |
Ottiene un valore che indica se il controllo è visibile in fase di progettazione. (Ereditato da ControlDesigner) |
Metodi
| Nome | Descrizione |
|---|---|
| AddDesignTimeCssAttributes(IDictionary) |
Aggiunge gli attributi di stile per il controllo in fase di progettazione. |
| CreateErrorDesignTimeHtml(String, Exception) |
Crea il markup HTML per visualizzare un messaggio di errore di eccezione specificato in fase di progettazione. (Ereditato da ControlDesigner) |
| CreateErrorDesignTimeHtml(String) |
Crea markup HTML per visualizzare un messaggio di errore specificato in fase di progettazione. (Ereditato da ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml() |
Fornisce una rappresentazione segnaposto rettangolare semplice che visualizza il tipo e l'ID del controllo. (Ereditato da ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml(String) |
Fornisce una rappresentazione segnaposto rettangolare semplice che visualizza il tipo e l'ID del controllo, nonché istruzioni o 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 e, facoltativamente, rilascia le risorse gestite. (Ereditato da HtmlControlDesigner) |
| DoDefaultAction() |
Crea una firma del metodo nel file del codice sorgente per l'evento predefinito nel 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 per il controllo come visualizzato nell'area di progettazione. (Ereditato da ControlDesigner) |
| GetDesignTimeCssAttributes() |
Restituisce l'insieme di attributi di stile per il controllo in fase di progettazione. |
| GetDesignTimeHtml() |
Recupera il markup HTML utilizzato 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. |
| GetEditableDesignerRegionContent(EditableDesignerRegion) |
Restituisce il contenuto per l'area modificabile del controllo in fase di progettazione. |
| 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 in fase di progettazione. |
| GetPersistInnerHtml() |
Obsoleti.
Recupera il markup HTML interno persistente del controllo. (Ereditato da ControlDesigner) |
| GetService(Type) |
Tenta di recuperare il tipo di servizio specificato dal sito in modalità progettazione del componente della finestra di progettazione. (Ereditato da ComponentDesigner) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| GetViewRendering() |
Recupera un oggetto che contiene il markup in fase di progettazione per il contenuto e le aree del controllo associato. (Ereditato da ControlDesigner) |
| Initialize(IComponent) |
Inizializza la finestra di progettazione dei controlli e carica il componente specificato. (Ereditato da ControlDesigner) |
| InitializeExistingComponent(IDictionary) |
Reinizializza un componente esistente. (Ereditato da ComponentDesigner) |
| InitializeNewComponent(IDictionary) |
Inizializza un componente appena creato. (Ereditato da ComponentDesigner) |
| InitializeNonDefault() |
Obsoleti.
Obsoleti.
Inizializza le impostazioni per un componente importato già inizializzato in impostazioni diverse dalle impostazioni predefinite. (Ereditato da ComponentDesigner) |
| Invalidate() |
Invalida l'intera area del controllo visualizzata nell'area di progettazione e segnala alla finestra di progettazione di ridisegnare il controllo. (Ereditato da ControlDesigner) |
| Invalidate(Rectangle) |
Invalida l'area specificata del controllo visualizzata nell'area di progettazione e segnala alla finestra di progettazione di ridisegnare il controllo. (Ereditato da ControlDesigner) |
| InvokeGetInheritanceAttribute(ComponentDesigner) |
Ottiene l'oggetto dell'oggetto InheritanceAttribute specificato ComponentDesigner. (Ereditato da ComponentDesigner) |
| IsPropertyBound(String) |
Obsoleti.
Recupera un valore che indica se la proprietà specificata nel controllo associato è associata a dati. (Ereditato da ControlDesigner) |
| Localize(IDesignTimeResourceWriter) |
Usa il writer di risorse fornito per rendere persistenti le proprietà localizzabili del controllo associato a una risorsa nell'host di progettazione. (Ereditato da ControlDesigner) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| OnAutoFormatApplied(DesignerAutoFormat) |
Chiamato quando al controllo associato è stato applicato uno schema di formattazione automatico predefinito. (Ereditato da ControlDesigner) |
| OnBehaviorDetaching() |
Obsoleti.
Chiamato quando un comportamento annulla l'associazione dall'elemento . (Ereditato da HtmlControlDesigner) |
| OnBindingsCollectionChanged(String) |
Obsoleti.
Chiamato quando cambia la raccolta di data binding. (Ereditato da ControlDesigner) |
| OnClick(DesignerRegionMouseEventArgs) |
Chiamato dall'host di progettazione quando l'utente fa clic sul controllo associato in fase di progettazione. (Ereditato da ControlDesigner) |
| OnComponentChanged(Object, ComponentChangedEventArgs) |
Chiamato quando cambia il 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 quando il controllo server Web associato è stato ridimensionato nell'host di progettazione in fase di progettazione. (Ereditato da ControlDesigner) |
| OnPaint(PaintEventArgs) |
Chiamato quando la finestra di progettazione dei controlli disegna il controllo associato nell'area di progettazione, se il CustomPaint valore è |
| OnSetComponentDefaults() |
Obsoleti.
Obsoleti.
Imposta le proprietà predefinite per il componente. (Ereditato da ComponentDesigner) |
| OnSetParent() |
Fornisce un modo per eseguire un'elaborazione aggiuntiva quando il controllo associato è collegato a un controllo padre. (Ereditato da HtmlControlDesigner) |
| PostFilterAttributes(IDictionary) |
Consente a una finestra di progettazione di modificare o rimuovere elementi dal set di attributi esposti tramite un oggetto TypeDescriptor. (Ereditato da ComponentDesigner) |
| PostFilterEvents(IDictionary) |
Consente a una finestra di progettazione di modificare o rimuovere elementi dal set di eventi esposti tramite un oggetto TypeDescriptor. (Ereditato da ComponentDesigner) |
| PostFilterProperties(IDictionary) |
Consente a una finestra di progettazione di modificare o rimuovere elementi dal set di proprietà esposte tramite un oggetto TypeDescriptor. (Ereditato da ComponentDesigner) |
| PreFilterAttributes(IDictionary) |
Consente a una finestra di progettazione di aggiungere al set di attributi 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 nuove proprietà in fase di progettazione che potrebbero corrispondere alle proprietà del 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 il 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 clonato. (Ereditato da ControlDesigner) |
| SetEditableDesignerRegionContent(EditableDesignerRegion, String) |
Imposta il contenuto per l'area modificabile del controllo in fase di progettazione. |
| SetRegionContent(EditableDesignerRegion, String) |
Specifica il contenuto di un'area modificabile nella visualizzazione in fase di progettazione del controllo. (Ereditato da ControlDesigner) |
| SetViewFlags(ViewFlags, Boolean) |
Assegna l'enumerazione bit per ViewFlags 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 in fase di progettazione per il controllo server Web associato chiamando il GetDesignTimeHtml metodo . (Ereditato da ControlDesigner) |
