Export (0) Print
Expand All

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)

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

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.

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

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Show:
© 2014 Microsoft