FormStartPosition Enum
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Specifies the initial position of a form.
public enum class FormStartPosition
[System.Runtime.InteropServices.ComVisible(true)]
public enum FormStartPosition
public enum FormStartPosition
[<System.Runtime.InteropServices.ComVisible(true)>]
type FormStartPosition =
type FormStartPosition =
Public Enum FormStartPosition
- Inheritance
- Attributes
Fields
Name | Value | Description |
---|---|---|
Manual | 0 | The position of the form is determined by the Location property. |
CenterScreen | 1 | The form is centered on the current display, and has the dimensions specified in the form's size. |
WindowsDefaultLocation | 2 | The form is positioned at the Windows default location and has the dimensions specified in the form's size. |
WindowsDefaultBounds | 3 | The form is positioned at the Windows default location and has the bounds determined by Windows default. |
CenterParent | 4 | The form is centered within the bounds of its parent form. |
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
.
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 );
}
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 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
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
.