Form.WindowState Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

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.

Exception Condition

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
Available since 1.1
Return to top