Control Constructors
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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.ControlPublic 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.ControlPublic Sub New (parent As Control, 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. 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.ControlPublic 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.
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.ControlPublic Sub New (parent As Control, 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.
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.
