This documentation is archived and is not being maintained.

FormStartPosition Enumeration

Specifies the initial position of a form.

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

'Declaration
<ComVisibleAttribute(True)> _
Public Enumeration FormStartPosition
'Usage
Dim instance As FormStartPosition

Member nameDescription
ManualThe position of the form is determined by the Location property.
CenterScreenThe form is centered on the current display, and has the dimensions specified in the form's size.
WindowsDefaultLocationThe form is positioned at the Windows default location and has the dimensions specified in the form's size.
WindowsDefaultBoundsThe form is positioned at the Windows default location and has the bounds determined by Windows default.
CenterParentThe form is centered within the bounds of its parent form.

This enumeration is used by the StartPosition property of the Form class. It represents the different start positions of the form. The default start position is WindowsDefaultLocation.

In this example, you change the form's start position to the center of the screen and display the position information using a label. This example assumes that you have already created a Form named Form1.

Public Sub InitMyForm()
   ' Adds a label to the form. 
   Dim label1 As New Label()
   label1.Location = New System.Drawing.Point(54, 128)
   label1.Name = "label1"
   label1.Size = New System.Drawing.Size(220, 80)
   label1.Text = "Start position information" 
   Me.Controls.Add(label1)

   ' Moves the start position to the center of the screen.
   StartPosition = FormStartPosition.CenterScreen
   ' Displays the position information.
   label1.Text = "The start position is " + StartPosition
End Sub 'InitMyForm

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

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

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0
Show: