Edit

Share via

PanelContainerDesigner.Initialize(IComponent) Method

  • Reference

Definition

Namespace:
System.Web.UI.Design.WebControls
Assembly:
System.Design.dll

Prepares the designer to view, edit, and design the associated control.

public:
 override void Initialize(System::ComponentModel::IComponent ^ component);
public override void Initialize (System.ComponentModel.IComponent component);
override this.Initialize : System.ComponentModel.IComponent -> unit
Public Overrides Sub Initialize (component As IComponent)

Parameters

component
IComponent

A Panel, which implements an IComponent.

Exceptions

ArgumentException

component is not a Panel or of a class derived from Panel.

Examples

The following code example shows how to override the Initialize method in a class that is inherited from the PanelContainerDesigner class to change the behavior of a control that is derived from the Panel class at design time. The example throws an ArgumentException exception, if the associated control is not a MyPanelContainer object.

// 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

' 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

Remarks

The visual designer calls the Initialize method when it is ready to use the designer to render the Panel control. The Initialize and its base methods configure properties and set up events that are necessary for the operation of the designer.

The component parameter is the Panel control that is associated with this designer or a copy of the Panel control.

Applies to

See also