Share via

Form.WindowState Property


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

 property System::Windows::Forms::FormWindowState WindowState { System::Windows::Forms::FormWindowState get(); void set(System::Windows::Forms::FormWindowState value); };
public System.Windows.Forms.FormWindowState WindowState { get; set; }
member this.WindowState : System.Windows.Forms.FormWindowState with get, set
Public Property WindowState As FormWindowState

Property Value

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


The value specified is outside the range of valid values.


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;  
Private  Sub Form1_Shown(ByVal sender As Object, ByVal e As EventArgs)  
            Me.WindowState = System.Windows.Forms.FormWindowState.Maximized  
End Sub  


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

See also