Form.TopMost Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft einen Wert ab, der angibt, ob das Formular als oberstes Formular angezeigt werden soll, oder legt diesen fest.

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

Eigenschaftswert

Boolean

true, um das Formular als oberstes Formular anzuzeigen, andernfalls false. Der Standardwert ist false.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie ein Formular am obersten Rand erstellen. Im Beispiel werden zwei Formulare erstellt, eines, das maximiert ist, und eines, das als oberstes Formular angezeigt wird. Das erste Formular mit dem Namen bottomFormwird mithilfe der WindowState -Eigenschaft maximiert angezeigt, um die Fähigkeiten des obersten Formulars besser zu veranschaulichen. Das zweite Formular mit dem Namen topMostFormlegt die TopMost -Eigenschaft auf fest, um true das Formular als oberstes Formular anzuzeigen. Wenn dieser Code ausgeführt wird, führt das Klicken auf das maximierte Formular nicht dazu, dass das oberste Formular unterhalb des maximierten Formulars angezeigt wird. Das Beispiel erfordert, dass die im Beispiel definierte Methode aus einem anderen Formular aufgerufen wird.

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

Hinweise

Eine oberste Form ist ein Formular, das alle anderen (nicht obersten) Formen überlappt, auch wenn es sich nicht um das aktive Formular oder das Vordergrundformular handelt. Die obersten Formulare werden immer am höchsten Punkt in der Z-Reihenfolge der Fenster auf dem Desktop angezeigt. Sie können diese Eigenschaft verwenden, um ein Formular zu erstellen, das immer in Ihrer Anwendung angezeigt wird, z. B. ein Toolfenster suchen und ersetzen.

Weitere Informationen

• TopLevel