Form.WindowState Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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.