Edit

Share via

Control Constructors

  • Reference

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()

Source:
Control.cs
Source:
Control.cs
Source:
Control.cs

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.

Applies to

Control(String)

Source:
Control.cs
Source:
Control.cs
Source:
Control.cs

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

public:
 Control(System::String ^ text);
public Control (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.

Applies to

Control(Control, String)

Source:
Control.cs
Source:
Control.cs
Source:
Control.cs

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);
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.

Applies to

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

Source:
Control.cs
Source:
Control.cs
Source:
Control.cs

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);
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.

Applies to

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

Source:
Control.cs
Source:
Control.cs
Source:
Control.cs

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);
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.

Applies to