Form.WindowState Property

Definition

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

public:
 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.

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

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

See also