FormStartPosition Enumeration

 

Specifies the initial position of a form.

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

[ComVisibleAttribute(true)]
public enum FormStartPosition

Member nameDescription
CenterParent

The form is centered within the bounds of its parent form.

CenterScreen

The form is centered on the current display, and has the dimensions specified in the form's size.

Manual

The position of the form is determined by the Location property.

WindowsDefaultBounds

The form is positioned at the Windows default location and has the bounds determined by Windows default.

WindowsDefaultLocation

The form is positioned at the Windows default location and has the dimensions specified in the form's size.

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 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;	
}

.NET Framework
Available since 1.1
Return to top
Show: