Export (0) Print
Expand All

Form.WindowState Property

Gets or sets a value that indicates whether form is minimized, maximized, or normal.

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

public FormWindowState WindowState { get; set; }

Property Value

Type: System.Windows.Forms.FormWindowState
A FormWindowState that represents whether form is minimized, maximized, or normal. The default is FormWindowState.Normal.

ExceptionCondition
InvalidEnumArgumentException

The value specified is outside the range of valid values.

Before a form is displayed, the WindowState property is always set to FormWindowState.Normal, regardless of its initial setting. This is reflected in the Height, Left, Top, and Width property settings. If a form is hidden after it has been shown, these properties reflect the previous state until the form is shown again, regardless of any changes made to the WindowState property.

The following code example demonstrates how to set the WindowStateto maximized. The code is called from the Shown event handler after the form has been created.

private void Form1_Shown(object sender, EventArgs e)
        {
            this.WindowState = System.Windows.Forms.FormWindowState.Maximized;
        }

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft