Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

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
/** @attribute ComVisibleAttribute(true) */ 
public enum FormStartPosition
ComVisibleAttribute(true) 
public enum FormStartPosition
 Member nameDescription
CenterParentThe form is centered within the bounds of its parent form. 
CenterScreenThe form is centered on the current display, and has the dimensions specified in the form's size. 
ManualThe position of the form is determined by the Location property. 
WindowsDefaultBoundsThe form is positioned at the Windows default location and has the bounds determined by Windows default. 
WindowsDefaultLocationThe 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;	
}

public void InitMyForm()
{
    // Adds a label to the form.
    Label label1 = new Label();

    label1.set_Location(new System.Drawing.Point(54, 128));
    label1.set_Name("label1");
    label1.set_Size(new System.Drawing.Size(220, 80));
    label1.set_Text("Start position information");
    this.get_Controls().Add(label1);

    // Moves the start position to the center of the screen.
    set_StartPosition(FormStartPosition.CenterScreen);

    // Displays the position information.
    label1.set_Text("The start position is " + get_StartPosition());
} //InitMyForm

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.