Form.WindowState Property

Definition

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

public System.Windows.Forms.FormWindowState WindowState { get; set; }

Property Value

A FormWindowState that represents whether form is minimized, maximized, or normal. The default is FormWindowState.Normal.

Exceptions

The value specified is outside the range of valid values.

Examples

The following example demonstrates how to set the WindowState to 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;
        }

Remarks

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.

Applies to

Product Versions
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

See also