DesignSurface::CreateNestedContainer Method (IComponent^, String^)

.NET Framework (current version)

Creates a container suitable for nesting controls or components.

Namespace: System.ComponentModel.Design
Assembly: System.Design (in System.Design.dll)

Syntax

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

Parameters

owningComponent: Type: System.ComponentModel::IComponent^
The component that manages the nested container.

containerName: Type: System::String^
An additional name for the nested container.

Return Value

Type: System.ComponentModel::INestedContainer^

The nested container.

Exceptions

Exception	Condition
ArgumentNullException	owningComponent is null.
ObjectDisposedException	The IDesignerHost attached to the DesignSurface has been disposed.

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.

Version Information

.NET Framework
Available since 2.0