Control Constructors

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Initializes a new instance of the Control class.

Overloads

Control()	Initializes a new instance of the Control class with default settings.
Control(String)	Initializes a new instance of the Control class with specific text.
Control(Control, String)	Initializes a new instance of the Control class as a child control, with specific text.
Control(String, Int32, Int32, Int32, Int32)	Initializes a new instance of the Control class with specific text, size, and location.
Control(Control, String, Int32, Int32, Int32, Int32)	Initializes a new instance of the Control class as a child control, with specific text, size, and location.

Control()

Initializes a new instance of the Control class with default settings.

public:
 Control();

public Control ();

Public Sub New ()

Remarks

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.

Control(String)

Initializes a new instance of the Control class with specific text.

public:
 Control(System::String ^ text);

public Control (string? text);

new System.Windows.Forms.Control : string -> System.Windows.Forms.Control

Public Sub New (text As String)

Parameters

text

String

The text displayed by the control.

Remarks

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.

Control(Control, String)

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

public:
 Control(System::Windows::Forms::Control ^ parent, System::String ^ text);

public Control (System.Windows.Forms.Control? parent, string? text);

new System.Windows.Forms.Control : System.Windows.Forms.Control * string -> System.Windows.Forms.Control

Public Sub New (parent As Control, text As String)

Parameters

parent

Control

The Control to be the parent of the control.

text

String

The text displayed by the control.

Remarks

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.

Control(String, Int32, Int32, Int32, Int32)

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

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

public Control (string? text, int left, int top, int width, int height);

new System.Windows.Forms.Control : string * int * int * int * int -> System.Windows.Forms.Control

Public Sub New (text As String, left As Integer, top As Integer, width As Integer, height As Integer)

Parameters

text

String

The text displayed by the control.

left

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

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

Int32

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

height

Int32

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

Remarks

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 initial Size and Location of the control are determined by the left, top, width and height parameter values.

Note

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

Control(Control, String, Int32, Int32, Int32, Int32)

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

public:
 Control(System::Windows::Forms::Control ^ parent, System::String ^ text, int left, int top, int width, int height);

public Control (System.Windows.Forms.Control? parent, string? text, int left, int top, int width, int height);

new System.Windows.Forms.Control : System.Windows.Forms.Control * string * int * int * int * int -> System.Windows.Forms.Control

Public Sub New (parent As Control, text As String, left As Integer, top As Integer, width As Integer, height As Integer)

Parameters

parent

Control

The Control to be the parent of the control.

text

String

The text displayed by the control.

left

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

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

Int32

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

height

Int32

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

Remarks

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.

Note

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