ControlDesigner Class

Definition

Fornisce una classe della finestra di progettazione di controlli di base per estendere il comportamento della modalità di progettazione di un controllo server Web.Provides a base control designer class for extending the design-mode behavior of a Web server control.

public ref class ControlDesigner : System::Web::UI::Design::HtmlControlDesigner
public class ControlDesigner : System.Web.UI.Design.HtmlControlDesigner
type ControlDesigner = class
    inherit HtmlControlDesigner
Public Class ControlDesigner
Inherits HtmlControlDesigner
Inheritance
Derived

Examples

Nell'esempio di codice seguente viene illustrato come creare una semplice classe della finestra di progettazione che deriva dalla classe ControlDesigner.The following code example demonstrates how to create a simple designer class that derives from the ControlDesigner class. Questa finestra di progettazione controlli supporta una classe TextControl personalizzata e fornisce un comando per modificare le dimensioni del testo di un controllo in fase di progettazione.This control designer supports a custom TextControl class and provides a command to change the text size of a control at design time. La finestra di progettazione controlli è associata al controllo specificando la finestra di progettazione del controllo in una dichiarazione dell'oggetto DesignerAttribute sulla classe TextControl.The control designer is associated with the control by specifying the control designer in a DesignerAttribute object declaration on the TextControl class. La chiave per salvare in modo permanente le modifiche alle proprietà dalla finestra di progettazione controlli al markup HTML si trova nel metodo ToggleTextSize della classe ActionList personalizzata.The key to persisting property changes from the control designer to the HTML markup is found in the ToggleTextSize method of the custom ActionList class.

Per provare l'esempio, aggiungere un riferimento all'assembly System. Design. dll e compilare il codice.To try the example, add a reference to the System.Design.dll assembly and compile the code.

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

namespace ASPNet.Design.Samples.CS
{
    // Simple text Web control renders a text string.
    // This control is associated with the TextSizeWebControlDesigner.
    [DesignerAttribute(typeof(TextSizeWebControlDesigner)),
    ToolboxData("<{0}:TextControl runat=\"server\"></{0}:TextControl>")]
    public class TextControl : Label
    {
        private bool _largeText = true;

        // Constructor
        public TextControl()
        {
            Text = "Test Phrase";
            SetSize();
        }

        // Determines whether the text is large or small
        [Bindable(true), Category("Appearance"), DefaultValue("true")]
        public bool LargeText
        {
            get { return _largeText; }
            set
            {
                _largeText = value;
                SetSize();
            }
        }

        // Applies the LargeText property to the control
        private void SetSize()
        {
            if (LargeText)
                this.Font.Size = FontUnit.XLarge;
            else
                this.Font.Size = FontUnit.Small;
        }
    }

    // This control designer offers DesignerActionList commands
    // that can alter the design time html of the associated control.
    public class TextSizeWebControlDesigner : ControlDesigner
    {
        private DesignerActionListCollection _actionLists = null;

        // Do not allow direct resizing of the control
        public override bool AllowResize
        {
            get { return false; }
        }

        // Return a custom ActionList collection
        public override DesignerActionListCollection ActionLists
        {
            get
            {
                if (_actionLists == null)
                {
                    _actionLists = new DesignerActionListCollection();
                    _actionLists.AddRange(base.ActionLists);

                    // Add a custom DesignerActionList
                    _actionLists.Add(new ActionList(this));
                }
                return _actionLists;
            }
        }

        public class ActionList : DesignerActionList
        {
            private TextSizeWebControlDesigner _parent;
            private DesignerActionItemCollection _items;

            // Constructor
            public ActionList(TextSizeWebControlDesigner parent)
                : base(parent.Component)
            {
                _parent = parent;
            }

            // Create the ActionItem collection and add one command
            public override DesignerActionItemCollection GetSortedActionItems()
            {
                if (_items == null)
                {
                    _items = new DesignerActionItemCollection();
                    _items.Add(new DesignerActionMethodItem(this, "ToggleLargeText", "Toggle Text Size", true));
                }
                return _items;
            }

            // ActionList command to change the text size
            private void ToggleLargeText()
            {
                // Get a reference to the parent designer's associated control
                TextControl ctl = (TextControl)_parent.Component;

                // Get a reference to the control's LargeText property
                PropertyDescriptor propDesc = TypeDescriptor.GetProperties(ctl)["LargeText"];

                // Get the current value of the property
                bool v = (bool)propDesc.GetValue(ctl);

                // Toggle the property value
                propDesc.SetValue(ctl, !v);
            }
        }
    }
}
Imports System.Web.UI
Imports System.Web.UI.Design
Imports System.Web.UI.WebControls
Imports System.ComponentModel
Imports System.ComponentModel.Design

Namespace ASPNet.Design.Samples.VB

    ' Simple text Web control renders a text string.
    ' This control is associated with the TextSizeWebControlDesigner.
    <DesignerAttribute(GetType(TextSizeWebControlDesigner)), _
        ToolboxData("<{0}:TextControl runat='server'></{0}:TextControl>")> _
    Public Class TextControl
        Inherits Label

        Private _largeText As Boolean = True

        ' Constructor
        Public Sub New()
            Text = "Test Phrase"
            SetSize()
        End Sub

        ' Determines whether the text is large or small
        <Bindable(True), Category("Appearance"), DefaultValue(True)> _
        Public Property LargeText() As Boolean
            Get
                Return _largeText
            End Get
            Set(ByVal value As Boolean)
                _largeText = value
                SetSize()
            End Set
        End Property

        ' Applies the LargeText property to the control
        Private Sub SetSize()
            If LargeText Then
                Me.Font.Size = FontUnit.XLarge
            Else
                Me.Font.Size = FontUnit.Small
            End If
        End Sub
    End Class


    ' This control designer offers DesignerActionList commands
    ' that can alter the design time html of the associated control.
    Public Class TextSizeWebControlDesigner
        Inherits ControlDesigner

        Private _actionLists As DesignerActionListCollection

        ' Do not allow direct resizing of the control
        Public Overrides ReadOnly Property AllowResize() As Boolean
            Get
                Return False
            End Get
        End Property

        ' Return a custom ActionList collection
        Public Overrides ReadOnly Property ActionLists() As System.ComponentModel.Design.DesignerActionListCollection
            Get
                If IsNothing(_actionLists) Then
                    _actionLists = New DesignerActionListCollection()
                    _actionLists.AddRange(MyBase.ActionLists)

                    ' Add a custom DesignerActionList
                    _actionLists.Add(New ActionList(Me))
                End If

                Return _actionLists
            End Get
        End Property

        ' Create a custom class of DesignerActionList
        Public Class ActionList
            Inherits DesignerActionList
            Private _parent As TextSizeWebControlDesigner
            Private _items As DesignerActionItemCollection

            ' Constructor
            Public Sub New(ByRef parent As TextSizeWebControlDesigner)
                MyBase.New(parent.Component)
                _parent = parent
            End Sub

            ' Create the ActionItem collection and add one command
            Public Overrides Function GetSortedActionItems() As DesignerActionItemCollection
                If IsNothing(_items) Then
                    _items = New DesignerActionItemCollection()
                    _items.Add(New DesignerActionMethodItem(Me, "ToggleLargeText", "Toggle Text Size", True))
                End If

                Return _items
            End Function

            ' ActionList command to change the text size
            Private Sub ToggleLargeText()
                ' Get a reference to the parent designer's associated control
                Dim ctl As TextControl = CType(_parent.Component, TextControl)

                ' Get a reference to the control's LargeText property
                Dim propDesc As PropertyDescriptor = TypeDescriptor.GetProperties(ctl)("LargeText")

                ' Get the current value of the property
                Dim v As Boolean = CType(propDesc.GetValue(ctl), Boolean)
                ' Toggle the property value
                propDesc.SetValue(ctl, (Not v))
            End Sub
        End Class
    End Class
End Namespace
<%@ Page Language="C#" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="ASPNet.Design.Samples.CS" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    
    <aspSample:TextControl ID="TextControl1" runat="server">
    </aspSample:TextControl>

    
    </div>
    </form>
</body>
</html>
<%@ Page Language="VB" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="ASPNet.Design.Samples.VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
    
        <aspSample:TextControl ID="TextControl1" runat="server">
        </aspSample:TextControl>
    
    </div>
    </form>
</body>
</html>

Remarks

La classe ControlDesigner fornisce una classe della finestra di progettazione di controlli di base che può essere ereditata da ed estesa per fornire supporto in fase di progettazione per un controllo server Web in un host di progettazione, ad esempio Visual Studio 2005Visual Studio 2005.The ControlDesigner class provides a base control designer class that can be inherited from and extended to provide design-time support for a Web server control in a design host, such as Visual Studio 2005Visual Studio 2005.

Il modello a oggetti per lavorare con il rendering in fase di progettazione è migliorato rispetto alle versioni precedenti, con le nuove classi di base seguenti per fornire l'accesso al modello a oggetti semplificato:The object model for working with design-time rendering is improved over earlier versions, with the following new base classes to provide access to the simplified object model:

Formattazione automaticaAutomatic Formatting

È possibile creare un'ampia gamma di formati automatici e predefiniti che consentono di semplificare il processo degli sviluppatori di pagine che applicano modifiche di stile complesse ai controlli server Web personalizzati.You can create a variety of automatic and pre-defined formats that can simplify the process of page developers who are applying complex style changes to custom Web server controls. Ad esempio, il controllo TableDesigner, che deriva dalla classe ControlDesigner, fornisce molti formati automatici tra cui scegliere.For example, the TableDesigner control, which derives from the ControlDesigner class, provides many automatic formats from which to choose. Per implementare e fornire la formattazione automatica nei controlli personalizzati, usare le funzionalità seguenti:To implement and provide automatic formatting in your custom controls, use the following features:

Elenchi di azioni (smart tag)Action Lists (Smart Tags)

Gli elenchi di azioni sono menu di attività importanti o molto diffuse che uno sviluppatore di pagine che utilizza un controllo può eseguire in un'interfaccia utente della fase di progettazione, ad esempio Visual Studio 2005Visual Studio 2005.Action lists are menus of important or widely used tasks that a page developer who uses a control can perform in a design-time user interface (UI), such as Visual Studio 2005Visual Studio 2005. Ad esempio, la visualizzazione della fase di progettazione del controllo potrebbe fornire un menu di attività disponibili.For example, the design-time view of your control could provide a menu of available tasks. Questo include un'attività per formattare automaticamente il controllo.This includes a task to format the control automatically. Per informazioni sugli elenchi di azioni, iniziare con le funzionalità seguenti:To learn about action lists, start with the following features:

Aree della finestra di progettazione controlliControl Designer Regions

Le aree sono aree modificabili nella visualizzazione della fase di progettazione di un controllo server Web.Regions are editable areas in the design-time view of a Web server control. Questa funzionalità offre la modifica simile a WYSIWYG del contenuto del modello, dei controlli interni e delle proprietà in fase di progettazione.This feature offers WYSIWYG-like editing of the template content, inner controls, and properties at design time. È possibile fare in modo che la finestra di progettazione controlli crei i controlli in aree oppure è possibile usare la casella degli strumenti per trascinare i controlli in aree.You can have the control designer create controls in regions or you can use the Toolbox to drag and drop controls into regions. Le aree vengono gestite con le funzionalità seguenti:Regions are managed with the following features:

ModelliTemplates

Il modello per la creazione di un'interfaccia utente per la modifica della fase di progettazione dei controlli basati su modelli, ad esempio il controllo GridView, è stato notevolmente migliorato rispetto alle versioni precedenti.The model for creating a UI for design-time editing of templated controls, such as the GridView control, has been greatly improved from earlier versions. È possibile creare controlli personalizzati complessi che includono modelli per varie parti del controllo e la finestra di progettazione controlli personalizzata può aiutare gli sviluppatori di pagine che modificano i modelli con le funzionalità seguenti:You can create complex custom controls that include templates for various parts of the control, and your custom control designer can help page developers who are modifying templates with the following features:

Rendering in fase di progettazioneDesign-Time Rendering

La classe ControlDesigner dispone dei metodi seguenti per supportare il rendering in fase di progettazione del controllo server Web.The ControlDesigner class has the following methods to support design-time rendering of the Web server control. La maggior parte di questi metodi è identica a quella delle versioni precedenti:Most of these methods are the same as in earlier versions:

Constructors

ControlDesigner()

Inizializza una nuova istanza della classe ControlDesigner.Initializes a new instance of the ControlDesigner class.

Properties

ActionLists

Ottiene la raccolta dell'elenco di azioni per questa finestra di progettazione controlli.Gets the action list collection for the control designer.

ActionLists

Ottiene gli elenchi di azioni in fase di progettazione supportati dal componente associato alla finestra di progettazione.Gets the design-time action lists supported by the component associated with the designer.

(Inherited from ComponentDesigner)
AllowResize

Ottiene un valore che indica se è possibile ridimensionare il controllo nell'ambiente Design-Time.Gets a value indicating whether the control can be resized in the design-time environment.

AssociatedComponents

Ottiene l'insieme dei componenti associati al componente gestito dalla finestra di progettazione.Gets the collection of components associated with the component managed by the designer.

(Inherited from 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.Gets the collection of predefined automatic formatting schemes to display in the Auto Format dialog box for the associated control at design time.

Behavior

Ottiene o imposta il comportamento DHTML associato alla finestra di progettazione.Gets or sets the DHTML behavior that is associated with the designer.

(Inherited from HtmlControlDesigner)
Component

Ottiene il componente progettato dalla finestra di progettazione.Gets the component this designer is designing.

(Inherited from ComponentDesigner)
DataBindings

Ottiene l'insieme di associazioni dati per il controllo corrente.Gets the data bindings collection for the current control.

(Inherited from HtmlControlDesigner)
DataBindingsEnabled

Ottiene un valore che indica se l'area contenitore per il controllo controllo associato supporta l'associazione di dati.Gets a value indicating whether data binding is supported by the containing region for the associated control.

DesignerState

Ottiene un oggetto utilizzato per rendere persistenti i dati per il controllo associato in fase di progettazione.Gets an object that is used to persist data for the associated control at design time.

DesignTimeElement

Ottiene l'oggetto in fase di progettazione che rappresenta il controllo associato all'oggetto HtmlControlDesigner sull'area di progettazione.Gets the design-time object representing the control that is associated with the HtmlControlDesigner object on the design surface.

(Inherited from HtmlControlDesigner)
DesignTimeElementView

Ottiene l'oggetto di controllo di visualizzazione per la finestra di progettazione.Gets the view-control object for the control designer.

DesignTimeHtmlRequiresLoadComplete

Ottiene un valore che indica se l'host di progettazione deve terminare il caricamento prima di poter chiamare il metodo GetDesignTimeHtml.Gets a value indicating whether the design host must finish loading before the GetDesignTimeHtml method can be called.

Expressions

Ottiene le associazioni di espressioni per il controllo corrente in fase di progettazione.Gets the expression bindings for the current control at design time.

(Inherited from HtmlControlDesigner)
HidePropertiesInTemplateMode

Ottiene un valore che indica se le proprietà del controllo associato sono nascoste quando per il controllo è attiva la modalità modello.Gets a value indicating whether the properties of the associated control are hidden when the control is in template mode.

ID

Ottiene o imposta a stringa ID per il controllo.Gets or sets the ID string for the control.

InheritanceAttribute

Ottiene un attributo che indica il tipo di ereditarietà del componente associato.Gets an attribute that indicates the type of inheritance of the associated component.

(Inherited from ComponentDesigner)
Inherited

Ottiene un valore che indica se questo componente è ereditato.Gets a value indicating whether this component is inherited.

(Inherited from ComponentDesigner)
InTemplateMode

Ottiene un valore che indica se il controllo è in modalità di visualizzazione o modifica del modello in un host di progettazione.Gets a value indicating whether the control is in either template viewing or editing mode in the design host. La proprietà InTemplateMode è di sola lettura.The InTemplateMode property is read-only.

IsDirty

Ottiene o imposta un valore che indica se il controllo server Web è stato contrassegnato come modificato.Gets or sets a value indicating whether the Web server control has been marked as changed.

ParentComponent

Ottiene il componente padre per la finestra di progettazione.Gets the parent component for this designer.

(Inherited from ComponentDesigner)
ReadOnly

Ottiene o imposta un valore che indica se le proprietà del controllo sono in sola lettura in fase di progettazione.Gets or sets a value indicating whether the properties of the control are read-only at design time.

RootDesigner

Ottiene la finestra di progettazione di controlli per la pagina del Web Form contenente il controllo associato.Gets the control designer for the Web Forms page that contains the associated control.

ShadowProperties

Ottiene un insieme di valori di proprietà che eseguono l'override delle impostazioni utente.Gets a collection of property values that override user settings.

(Inherited from ComponentDesigner)
ShouldCodeSerialize

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.Gets or sets a value indicating whether to create a field declaration for the control in the code-behind file for the current design document during serialization.

(Inherited from HtmlControlDesigner)
Tag

Ottiene un oggetto che rappresenta l'elemento del markup HTML per il controllo associato.Gets an object representing the HTML markup element for the associated control.

TemplateGroups

Ottiene una raccolta di gruppi di modelli, ognuno contenente una o più definizioni di modello.Gets a collection of template groups, each containing one or more template definitions.

UsePreviewControl

Ottiene un valore che indica se la finestra di progettazione controlli usa un controllo di anteprima temporaneo per generare il markup HTML in fase di progettazione.Gets a value indicating whether the control designer uses a temporary preview control to generate the design-time HTML markup.

Verbs

Ottiene i verbi in fase di progettazione supportati dal componente associato alla finestra di progettazione.Gets the design-time verbs supported by the component that is associated with the designer.

(Inherited from ComponentDesigner)
ViewControl

Ottiene o imposta un controllo server Web che può essere utilizzato per visualizzare in anteprima il markup HTML Design-Time.Gets or sets a Web server control that can be used for previewing the design-time HTML markup.

ViewControlCreated

Ottiene o imposta un valore che indica se il controllo View è stato creato per la visualizzazione nell'area di progettazione.Gets or sets a value indicating whether a View control has been created for display on the design surface.

Visible

Ottiene un valore che indica se il controllo è visibile in fase di progettazione.Gets a value that indicates whether the control is visible at design time.

Methods

CreateErrorDesignTimeHtml(String)

Crea il markup HTML per visualizzare un messaggio di errore specificato in fase di progettazione.Creates HTML markup to display a specified error message at design time.

CreateErrorDesignTimeHtml(String, Exception)

Crea il markup HTML per visualizzare un messaggio di errore di eccezione specificato in fase di progettazione.Creates the HTML markup to display a specified exception error message at design time.

CreatePlaceHolderDesignTimeHtml()

Fornisce una rappresentazione del segnaposto rettangolare semplice che visualizza il tipo e l'ID del controllo.Provides a simple rectangular placeholder representation that displays the type and ID of the control.

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.Provides a simple rectangular placeholder representation that displays the type and ID of the control, and also additional specified instructions or information.

CreateViewControl()

Restituisce una copia del controllo associato per la visualizzazione o il rendering nell'area di progettazione.Returns a copy of the associated control for viewing or rendering on the design surface.

Dispose()

Rilascia tutte le risorse utilizzate da ComponentDesigner.Releases all resources used by the ComponentDesigner.

(Inherited from ComponentDesigner)
Dispose(Boolean)

Rilascia le risorse non gestite usate dall'oggetto HtmlControlDesigner ed eventualmente le risorse gestite.Releases the unmanaged resources that are used by the HtmlControlDesigner object and optionally releases the managed resources.

(Inherited from 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.Creates a method signature in the source code file for the default event on the component and navigates the user's cursor to that location.

(Inherited from ComponentDesigner)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetBounds()

Recupera le coordinate del rettangolo che rappresenta i limiti del controllo come visualizzato nell'area di progettazione.Retrieves the coordinates of the rectangle representing the boundaries for the control as displayed on the design surface.

GetDesignTimeHtml()

Recupera il markup HTML usato per rappresentare il controllo in fase di progettazione.Retrieves the HTML markup that is used to represent the control at design time.

GetDesignTimeHtml(DesignerRegionCollection)

Recupera il markup HTML per la visualizzazione del controllo e popola la raccolta con le aree della finestra di progettazione controlli correnti.Retrieves the HTML markup to display the control and populates the collection with the current control designer regions.

GetDesignTimeResourceProviderFactory(IServiceProvider)

Restituisce una factory di provider di risorse appropriata a seconda delle impostazioni di globalizzazione specificate nel file di configurazione del sito.Returns an appropriate resource provider factory, depending on the globalization settings in the configuration file for the site.

GetEditableDesignerRegionContent(EditableDesignerRegion)

Restituisce il contenuto per un'area modificabile della visualizzazione Design-Time del controllo associato.Returns the content for an editable region of the design-time view of the associated control.

GetEmptyDesignTimeHtml()

Recupera il markup HTML per rappresentare un controllo server Web in fase di progettazione che non avrà rappresentazione visiva in fase di esecuzione.Retrieves the HTML markup to represent a Web server control at design time that will have no visual representation at run time.

GetErrorDesignTimeHtml(Exception)

Recupera il markup HTML che fornisce informazioni sull'eccezione specificata.Retrieves the HTML markup that provides information about the specified exception.

GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetPersistenceContent()

Recupera il markup HTML interno persistente del controllo in fase di progettazione.Retrieves the persistable inner HTML markup of the control at design time.

GetPersistInnerHtml()

Recupera il markup HTML interno persistente del controllo.Retrieves the persistable inner HTML markup of the control.

GetService(Type)

Esegue un tentativo di recuperare il tipo di servizio specificato dal sito della modalità progettazione del componente della finestra di progettazione.Attempts to retrieve the specified type of service from the design mode site of the designer's component.

(Inherited from ComponentDesigner)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
GetViewRendering()

Recupera un oggetto contenente il markup Design-Time per il contenuto e le aree del controllo associato.Retrieves an object that contains the design-time markup for the content and regions of the associated control.

GetViewRendering(Control)

Recupera un oggetto contenente il markup Design-Time per il contenuto e le aree del controllo specificato.Retrieves an object that contains the design-time markup for the content and regions of the specified control.

GetViewRendering(ControlDesigner)

Recupera un oggetto contenente il markup Design-Time per il contenuto e le aree del controllo associato per la finestra di progettazione di controlli specificata.Retrieves an object that contains the design-time markup for the content and regions of the associated control for the specified control designer.

Initialize(IComponent)

Inizializza la finestra di progettazione di controlli e carica il componente specificato.Initializes the control designer and loads the specified component.

InitializeExistingComponent(IDictionary)

Reinizializza un componente esistente.Reinitializes an existing component.

(Inherited from ComponentDesigner)
InitializeNewComponent(IDictionary)

Inizializza un nuovo componente creato.Initializes a newly created component.

(Inherited from ComponentDesigner)
InitializeNonDefault()

Inizializza le impostazioni relative a un componente importato già inizializzato per impostazioni diverse da quelle predefinite.Initializes the settings for an imported component that is already initialized to settings other than the defaults.

(Inherited from 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.Invalidates the whole area of the control that is displayed on the design surface and signals the control designer to redraw the control.

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.Invalidates the specified area of the control that is displayed on the design surface and signals the control designer to redraw the control.

InvokeGetInheritanceAttribute(ComponentDesigner)

Ottiene l'oggetto InheritanceAttribute dell'oggetto ComponentDesigner specificato.Gets the InheritanceAttribute of the specified ComponentDesigner.

(Inherited from ComponentDesigner)
InvokeTransactedChange(IComponent, TransactedChangeCallback, Object, String)

Contiene una serie di modifiche in una transazione, utilizzando i parametri specificati che possono eseguire il rollback come unità mediante la funzionalità di annullamento dell'host di progettazione.Wraps a series of changes into a transaction, using the specified parameters that can be rolled back as a unit with the undo functionality of the design host.

InvokeTransactedChange(IComponent, TransactedChangeCallback, Object, String, MemberDescriptor)

Contiene una serie di modifiche in una transazione, utilizzando i parametri specificati che possono eseguire il rollback come unità mediante la funzionalità di annullamento dell'host di progettazione.Wraps a series of changes into a transaction, using the specified parameters that can be rolled back as a unit with the undo functionality of the design host.

InvokeTransactedChange(IServiceProvider, IComponent, TransactedChangeCallback, Object, String, MemberDescriptor)

Contiene una serie di modifiche in una transazione, utilizzando i parametri specificati che possono eseguire il rollback come unità mediante la funzionalità di annullamento dell'host di progettazione.Wraps a series of changes into a transaction, using the specified parameters that can be rolled back as a unit with the undo functionality of the design host.

IsPropertyBound(String)

Recupera un valore che indica se la proprietà specificata sul controllo associato prevede l'associazione a dati.Retrieves a value indicating whether the specified property on the associated control is data-bound.

Localize(IDesignTimeResourceWriter)

Utilizza il writer di risorse fornito per rendere persistenti le proprietà localizzate del controllo associato in una risorsa nell'host di progettazione.Uses the provided resource writer to persist the localizable properties of the associated control to a resource in the design host.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
OnAutoFormatApplied(DesignerAutoFormat)

Chiamato dopo che è stato applicato uno schema di formattazione automatica e predefinito al controllo associato.Called when a predefined, automatic formatting scheme has been applied to the associated control.

OnBehaviorAttached()

Chiamato quando la finestra di progettazione di controlli è collegata a un oggetto Behavior.Called when the control designer is attached to a Behavior object.

OnBehaviorAttached()

Chiamato quando un comportamento è associato a un elemento.Called when a behavior is associated with the element.

(Inherited from HtmlControlDesigner)
OnBehaviorDetaching()

Chiamato quando viene annullata un'associazione di un comportamento dall'elemento.Called when a behavior disassociates from the element.

(Inherited from HtmlControlDesigner)
OnBindingsCollectionChanged(String)

Chiamato se viene modificato l'insieme di associazioni dati.Called when the data-binding collection changes.

OnClick(DesignerRegionMouseEventArgs)

Chiamato dall'host di progettazione quando l'utente fa clic su un controllo associato in fase di progettazione.Called by the design host when the user clicks the associated control at design time.

OnComponentChanged(Object, ComponentChangedEventArgs)

Viene chiamato in caso di modifica del controllo associato.Called when the associated control changes.

OnComponentChanging(Object, ComponentChangingEventArgs)

Rappresenta il metodo che gestirà l'evento ComponentChanging per il controllo associato.Represents the method that will handle the ComponentChanging event for the associated control.

OnControlResize()

Chiamato se il controllo server Web associato è stato ridimensionato nell'host di progettazione in fase di progettazione.Called when the associated Web server control has been resized in the design host at design time.

OnPaint(PaintEventArgs)

Chiamato se la finestra di progettazione di controlli crea il controllo associato sull'area di progettazione, se il valore CustomPaint è true.Called when the control designer draws the associated control on the design surface, if the CustomPaint value is true.

OnSetComponentDefaults()

Imposta le proprietà predefinite relative al componente.Sets the default properties for the component.

(Inherited from ComponentDesigner)
OnSetParent()

Fornisce un modo per eseguire un'ulteriore elaborazione quando il controllo associato viene connesso al controllo padre.Provides a way to perform additional processing when the associated control is attached to a parent control.

(Inherited from HtmlControlDesigner)
PostFilterAttributes(IDictionary)

Consente a una finestra di progettazione di modificare o rimuovere elementi dall'insieme di attributi esposti tramite un oggetto TypeDescriptor.Allows a designer to change or remove items from the set of attributes that it exposes through a TypeDescriptor.

(Inherited from ComponentDesigner)
PostFilterEvents(IDictionary)

Consente a una finestra di progettazione di modificare o rimuovere elementi dal gruppo di eventi esposti tramite un oggetto TypeDescriptor.Allows a designer to change or remove items from the set of events that it exposes through a TypeDescriptor.

(Inherited from ComponentDesigner)
PostFilterProperties(IDictionary)

Consente a una finestra di progettazione di modificare o rimuovere elementi dall'insieme di proprietà esposte tramite un oggetto TypeDescriptor.Allows a designer to change or remove items from the set of properties that it exposes through a TypeDescriptor.

(Inherited from ComponentDesigner)
PreFilterAttributes(IDictionary)

Consente a una finestra di progettazione di aggiungere un insieme di attributi che vengono esposti tramite un oggetto TypeDescriptor.Allows a designer to add to the set of attributes that it exposes through a TypeDescriptor.

(Inherited from ComponentDesigner)
PreFilterEvents(IDictionary)

Imposta l'elenco di eventi esposti in fase di progettazione per l'oggetto TypeDescriptor per il componente.Sets the list of events that are exposed at design-time for the TypeDescriptor object for the component.

(Inherited from 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.Adds properties to or removes properties from the Properties grid in a design host at design time or provides new design-time properties that might correspond to properties on the associated control.

RaiseComponentChanged(MemberDescriptor, Object, Object)

Notifica all'oggetto IComponentChangeService che questo componente è stato modificato.Notifies the IComponentChangeService that this component has been changed.

(Inherited from ComponentDesigner)
RaiseComponentChanging(MemberDescriptor)

Notifica all'oggetto IComponentChangeService che questo componente sta per essere modificato.Notifies the IComponentChangeService that this component is about to be changed.

(Inherited from ComponentDesigner)
RaiseResizeEvent()

Genera l'evento OnControlResize().Raises the OnControlResize() event.

RegisterClone(Object, Object)

Registra i dati interni in un controllo duplicato.Registers internal data in a cloned control.

SetEditableDesignerRegionContent(EditableDesignerRegion, String)

Specifica il contenuto di un'area modificabile del controllo in fase di progettazione.Specifies the content for an editable region of the control at design time.

SetRegionContent(EditableDesignerRegion, String)

Specifica il contenuto per un'area modificabile della visualizzazione Design-Time del controllo.Specifies the content for an editable region in the design-time view of the control.

SetViewFlags(ViewFlags, Boolean)

Assegna l'enumerazione ViewFlags bit per bit specificata al valore del flag specificato.Assigns the specified bitwise ViewFlags enumeration to the specified flag value.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)
UpdateDesignTimeHtml()

Aggiorna il markup HTML Design-Time per il controllo server Web associato mediante la chiamata al metodo GetDesignTimeHtml.Refreshes the design-time HTML markup for the associated Web server control by calling the GetDesignTimeHtml method.

Explicit Interface Implementations

IDesignerFilter.PostFilterAttributes(IDictionary)

Per una descrizione di questo membro, vedere il metodo PostFilterAttributes(IDictionary).For a description of this member, see the PostFilterAttributes(IDictionary) method.

(Inherited from ComponentDesigner)
IDesignerFilter.PostFilterEvents(IDictionary)

Per una descrizione di questo membro, vedere il metodo PostFilterEvents(IDictionary).For a description of this member, see the PostFilterEvents(IDictionary) method.

(Inherited from ComponentDesigner)
IDesignerFilter.PostFilterProperties(IDictionary)

Per una descrizione di questo membro, vedere il metodo PostFilterProperties(IDictionary).For a description of this member, see the PostFilterProperties(IDictionary) method.

(Inherited from ComponentDesigner)
IDesignerFilter.PreFilterAttributes(IDictionary)

Per una descrizione di questo membro, vedere il metodo PreFilterAttributes(IDictionary).For a description of this member, see the PreFilterAttributes(IDictionary) method.

(Inherited from ComponentDesigner)
IDesignerFilter.PreFilterEvents(IDictionary)

Per una descrizione di questo membro, vedere il metodo PreFilterEvents(IDictionary).For a description of this member, see the PreFilterEvents(IDictionary) method.

(Inherited from ComponentDesigner)
IDesignerFilter.PreFilterProperties(IDictionary)

Per una descrizione di questo membro, vedere il metodo PreFilterProperties(IDictionary).For a description of this member, see the PreFilterProperties(IDictionary) method.

(Inherited from ComponentDesigner)
ITreeDesigner.Children

Per una descrizione di questo membro, vedere la proprietà Children.For a description of this member, see the Children property.

(Inherited from ComponentDesigner)
ITreeDesigner.Parent

Per una descrizione di questo membro, vedere la proprietà Parent.For a description of this member, see the Parent property.

(Inherited from ComponentDesigner)

Applies to

See also