Control Constructor (Control^, String^, Int32, Int32, Int32, Int32)

 

Initializes a new instance of the Control class as a child control, with specific text, size, and location.

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

public:
Control(
	Control^ parent,
	String^ text,
	int left,
	int top,
	int width,
	int height
)

Parameters

parent
Type: System.Windows.Forms::Control^

The Control to be the parent of the control.

text
Type: System::String^

The text displayed by the control.

left
Type: System::Int32

The X position of the control, in pixels, from the left edge of the control's container. The value is assigned to the Left property.

top
Type: System::Int32

The Y position of the control, in pixels, from the top edge of the control's container. The value is assigned to the Top property.

width
Type: System::Int32

The width of the control, in pixels. The value is assigned to the Width property.

height
Type: System::Int32

The height of the control, in pixels. The value is assigned to the Height property.

The Control class is the base class for all controls used in a Windows Forms application. Because this class is not typically used to create an instance of the class, this constructor is typically not called directly but is instead called by a derived class.

This version of the Control constructor sets the initial Text property value to the text parameter value. The constructor also adds the control to the parent control's Control::ControlCollection. The initial Size and Location of the control are determined by the left, top, width and height parameter values.

System_CAPS_noteNote

To maintain better performance, do not set the size of a control in its constructor. The preferred method is to override the DefaultSize property.

.NET Framework
Available since 1.1
Return to top
Show: