FormStartPosition Enumeration (System.Windows.Forms)

FormStartPosition Enumeration

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2010/.NET Framework 4

Other versions are also available for the following:

.NET Framework Class Library

FormStartPosition Enumeration

Specifies the initial position of a form.

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

Syntax

Visual Basic

<ComVisibleAttribute(True)> _
Public Enumeration FormStartPosition

[ComVisibleAttribute(true)]
public enum FormStartPosition

Visual C++

[ComVisibleAttribute(true)]
public enum class FormStartPosition

[<ComVisibleAttribute(true)>]
type FormStartPosition

Members

	Member name	Description
	Manual	The position of the form is determined by the Location property.
	CenterScreen	The form is centered on the current display, and has the dimensions specified in the form's size.
	WindowsDefaultLocation	The form is positioned at the Windows default location and has the dimensions specified in the form's size.
	WindowsDefaultBounds	The form is positioned at the Windows default location and has the bounds determined by Windows default.
	CenterParent	The form is centered within the bounds of its parent form.

Remarks

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.

Examples

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.

Visual Basic

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

public void InitMyForm()
{
    // Adds a label to the form.
    Label label1 = 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";
    this.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;    
}

Visual C++

public:
   void InitMyForm()
   {
      // Adds a label to the form.
      Label^ label1 = gcnew Label;
      label1->Location = System::Drawing::Point( 54, 128 );
      label1->Name = "label1";
      label1->Size = System::Drawing::Size( 220, 80 );
      label1->Text = "Start position information";
      this->Controls->Add( label1 );

      // Moves the start position to the center of the screen.
      StartPosition = FormStartPosition::CenterScreen;

      // Displays the position information.
      label1->Text = String::Format( "The start position is {0}", StartPosition );
   }

Version Information

.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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

Reference

System.Windows.Forms Namespace

StartPosition