Cette documentation est archivée et n’est pas conservée.

Form.WindowState, propriété

Obtient ou définit l'état de la fenêtre du formulaire.

Espace de noms : System.Windows.Forms
Assembly : System.Windows.Forms (dans system.windows.forms.dll)

public FormWindowState WindowState { get; set; }
/** @property */
public FormWindowState get_WindowState ()

/** @property */
public void set_WindowState (FormWindowState value)

public function get WindowState () : FormWindowState

public function set WindowState (value : FormWindowState)

Valeur de la propriété

FormWindowState qui représente l'état de la fenêtre du formulaire. La valeur par défaut est FormWindowState.Normal.

Type d'exceptionCondition

InvalidEnumArgumentException

La valeur spécifiée ne figure pas dans la plage des valeurs valides.

Avant qu'un formulaire ne soit affiché, la propriété WindowState a toujours la valeur FormWindowState.Normal, quelle que soit sa valeur initiale. Ceci se reflète dans les paramètres de propriété Height, Left, Top et Width. Si un formulaire est masqué après avoir été affiché, ces propriétés reflètent l'état précédent jusqu'au nouvel affichage du formulaire, sans tenir compte des modifications apportées à la propriété WindowState.

L'exemple de code suivant illustre la création d'un formulaire situé au-dessus de tous les autres formulaires. L'exemple crée deux formulaires, l'un agrandi et l'autre s'affichant en tant que formulaire situé au-dessus de tous les autres formulaires. Le premier formulaire, nommé bottomForm, s'affiche agrandi, grâce à la propriété WindowState, ce qui permet de mieux illustrer les possibilités du formulaire situé au-dessus de tous les autres. Le second formulaire, nommé topMostForm, affecte à la propriété TopMost la valeur true de telle sorte que le formulaire s'affiche en tant que formulaire situé au-dessus de tous les autres. Lorsque ce code s'exécute, le fait de cliquer sur un formulaire agrandi ne fait pas passer le formulaire de premier plan sous le formulaire agrandi. L'exemple requiert que la méthode définie dans l'exemple soit appelée à partir d'un autre formulaire.

private void CreateMyTopMostForm()
{
   // Create lower form to display.
   Form bottomForm = new Form();
   // Display the lower form Maximized to demonstrate effect of TopMost property.
   bottomForm.WindowState = FormWindowState.Maximized;
   // Display the bottom form.
   bottomForm.Show();
   // Create the top most form.
   Form topMostForm = new Form();
   // Set the size of the form larger than the default size.
   topMostForm.Size = new Size(300,300);
   // Set the position of the top most form to center of screen.
   topMostForm.StartPosition = FormStartPosition.CenterScreen;
   // Display the form as top most form.
   topMostForm.TopMost = true;
   topMostForm.Show();
}

private void CreateMyTopMostForm()
{
    // Create lower form to display.
    Form bottomForm = new Form();

    // Display the lower form Maximized to demonstrate effect
    // of TopMost property.
    bottomForm.set_WindowState(FormWindowState.Maximized);

    // Display the bottom form.
    bottomForm.Show();

    // Create the top most form.
    Form topMostForm = new Form();

    // Set the size of the form larger than the default size.
    topMostForm.set_Size(new Size(300, 300));

    // Set the position of the top most form to center of screen.
    topMostForm.set_StartPosition(FormStartPosition.CenterScreen);

    // Display the form as top most form.
    topMostForm.set_TopMost(true);
    topMostForm.Show();
} //CreateMyTopMostForm

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0
Afficher: