Form.TopMost Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene o imposta un valore che indica se il form deve essere visualizzato come form sempre in primo piano.

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

Valore della proprietà

Boolean

true per visualizzare il form come form sempre in primo piano; in caso contrario, false. Il valore predefinito è false.

Esempio

Nell'esempio seguente viene illustrato come creare un modulo in primo piano. Nell'esempio vengono create due forme, una ingrandita e una che verrà visualizzata come maschera superiore. La prima maschera, denominata bottomForm, viene visualizzata ingrandita, usando la WindowState proprietà , per illustrare meglio le capacità della forma superiore. La seconda maschera, denominata topMostForm, imposta la TopMost proprietà su per true visualizzare il modulo come maschera superiore. Quando questo codice viene eseguito, facendo clic sul modulo ingrandita non verrà visualizzato il modulo in alto sotto il modulo ingrandita. L'esempio richiede che il metodo definito nell'esempio venga chiamato da un altro modulo.

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

Commenti

Una maschera in alto è una maschera che si sovrappone a tutte le altre forme (all'inizio) anche se non è attiva o in primo piano. I moduli più in alto vengono sempre visualizzati al punto più alto nell'ordine z delle finestre sul desktop. È possibile usare questa proprietà per creare un modulo sempre visualizzato nell'applicazione, ad esempio una finestra degli strumenti Trova e sostituisci.

Vedi anche

• TopLevel