Form.TopMost Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit une valeur indiquant si le formulaire doit être affiché comme un formulaire de premier plan.

public:
 property bool TopMost { bool get(); void set(bool value); };

public bool TopMost { get; set; }

member this.TopMost : bool with get, set

Public Property TopMost As Boolean

Valeur de propriété

Boolean

true pour afficher le formulaire comme un formulaire de premier plan ; sinon, false. La valeur par défaut est false.

Exemples

L’exemple suivant montre comment créer un formulaire le plus haut. L’exemple crée deux formulaires, un qui est agrandi et un qui sera affiché sous la forme d’un formulaire le plus haut. Le premier formulaire, nommé bottomForm, est affiché agrandi, à l’aide de la WindowState propriété, pour mieux illustrer les capacités du formulaire le plus haut. Le deuxième formulaire, nommé topMostForm, définit la TopMost propriété pour true afficher le formulaire sous la forme d’un formulaire le plus haut. Lorsque ce code est exécuté, le fait de cliquer sur le formulaire agrandi n’entraîne pas l’affichage du formulaire le plus haut sous le formulaire agrandi. L’exemple exige 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 = gcnew 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 = gcnew Form;

      // Set the size of the form larger than the default size.
      topMostForm->Size = System::Drawing::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.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 Sub CreateMyTopMostForm()
   ' Create lower form to display.
   Dim bottomForm As 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.
   Dim topMostForm As 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()
End Sub

Remarques

Un formulaire le plus haut est un formulaire qui chevauche tous les autres formulaires (non les plus hauts) même s’il n’est pas le formulaire actif ou au premier plan. Les formulaires les plus hauts sont toujours affichés au point le plus élevé dans l’ordre z des fenêtres sur le bureau. Vous pouvez utiliser cette propriété pour créer un formulaire toujours affiché dans votre application, tel qu’une fenêtre outil Rechercher et remplacer.

Voir aussi

• TopLevel