DesignSurface.CreateNestedContainer Method

Definition

Namespace:

System.ComponentModel.Design

Assembly:

System.Windows.Forms.Design.dll

Creates a container suitable for nesting controls or components.

Overloads

CreateNestedContainer(IComponent)	Creates a container suitable for nesting controls or components.
CreateNestedContainer(IComponent, String)	Creates a container suitable for nesting controls or components.

CreateNestedContainer(IComponent)

Source:

DesignSurface.cs

Creates a container suitable for nesting controls or components.

public:
 System::ComponentModel::INestedContainer ^ CreateNestedContainer(System::ComponentModel::IComponent ^ owningComponent);

public System.ComponentModel.INestedContainer CreateNestedContainer (System.ComponentModel.IComponent owningComponent);

member this.CreateNestedContainer : System.ComponentModel.IComponent -> System.ComponentModel.INestedContainer

Public Function CreateNestedContainer (owningComponent As IComponent) As INestedContainer

Parameters

owningComponent

IComponent

The component that manages the nested container.

Returns

INestedContainer

The nested container.

Exceptions

ArgumentNullException

owningComponent is null.

ObjectDisposedException

The IDesignerHost attached to the DesignSurface has been disposed.

Remarks

Adding a component to a nested container creates its designer and makes it eligible for all services available from the design surface. Components added to nested containers do not participate in serialization.

CreateNestedContainer(IComponent, String)

Source:

DesignSurface.cs

Creates a container suitable for nesting controls or components.

public:
 System::ComponentModel::INestedContainer ^ CreateNestedContainer(System::ComponentModel::IComponent ^ owningComponent, System::String ^ containerName);

public System.ComponentModel.INestedContainer CreateNestedContainer (System.ComponentModel.IComponent owningComponent, string? containerName);

member this.CreateNestedContainer : System.ComponentModel.IComponent * string -> System.ComponentModel.INestedContainer

Public Function CreateNestedContainer (owningComponent As IComponent, containerName As String) As INestedContainer

Parameters

owningComponent

IComponent

The component that manages the nested container.

containerName

String

An additional name for the nested container.

Returns

INestedContainer

The nested container.

Exceptions

ArgumentNullException

owningComponent is null.

ObjectDisposedException

The IDesignerHost attached to the DesignSurface has been disposed.

Remarks

Adding a component to a nested container creates its designer and makes it eligible for all services available from the design surface. Components added to nested containers do not participate in serialization.

You can provide an additional name for the CreateNestedContainer method by passing a value into containerName.