MenuDesigner.Initialize(IComponent) Method

Reference

Definition

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

Assembly:: System.Design.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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 Menu, which implements the IComponent interface.

Exceptions

ArgumentException

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

Examples

The following code example shows how to override the Initialize method in a class that is inherited from the MenuDesigner class. The overridden method changes the behavior of a control that is derived from the Menu class at design time. The example throws an ArgumentException exception, if the associated control is not a MyMenu object.

public override void Initialize(IComponent component)
{
    // Ensure that only a MyMenu can be created in this designer.
    if (!(component is MyMenu))
        throw new ArgumentException(
            "The component is not a MyMenu control.");
    
    base.Initialize(component);
} // Initialize

Public Overrides Sub Initialize(ByVal component As IComponent)

    ' Ensure that only a MyMenu can be created in this designer. 
    If Not TypeOf component Is MyMenu Then
        Throw New ArgumentException( _
            "The component is not a MyMenu control.")
    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 Menu control. The Initialize method and its base methods configure properties and set up events that are necessary for the operation of the designer.

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

Applies to