This topic has not yet been rated - Rate this topic

ControlDesigner.EnableDesignMode Method

.NET Framework 4

Other Versions

Enables design time functionality for a child control.

Namespace: System.Windows.Forms.Design
Assembly: System.Design (in System.Design.dll)

Syntax

C++

Copy

protected bool EnableDesignMode(
	Control child,
	string name
)

Parameters

child: Type: System.Windows.Forms.Control
The child control for which design mode will be enabled.

name: Type: System.String
The name of child as exposed to the end user.

Return Value

Type: System.Boolean
true if the child control could be enabled for design time; false if the hosting infrastructure does not support it.

Exceptions

Exception	Condition
ArgumentNullException	child or name is null.

Remarks

The child control specified by child is a child of this control designer's control. The child does not directly participate in persistence, but it will if it is exposed as a property of the main control. Consider a control like the SplitContainer: it has two panels, Panel1 and Panel2. These panels are exposed through read only Panel1 and Panel2 properties on the SplitContainer control. The SplitContainer control's designer calls EnableDesignMode for each panel, which allows other components to be dropped on them. But, in order for the contents of Panel1 and Panel2 to be saved, the SplitContainer control itself must expose the panels as public properties.

Control names must be unique within a control designer, but they are not required to be unique with respect to the children of other control designers.

To support this feature, the hosting infrastructure must expose the INestedContainer class as a service through the site.

Version Information

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

ControlDesigner Class

System.Windows.Forms.Design Namespace

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Content Add

FAQ