Form.TopMost Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece un valor que indica si el formulario debe mostrarse como un formulario de nivel superior.

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

Valor de propiedad

Boolean

true para mostrar el formulario como formulario de nivel superior; de lo contrario, false. De manera predeterminada, es false.

Ejemplos

En el ejemplo siguiente se muestra cómo crear un formulario de nivel superior. En el ejemplo se crean dos formularios, uno maximizado y otro que se mostrará como un formulario superior. El primer formulario, denominado bottomForm, se muestra maximizado, utilizando la WindowState propiedad , para demostrar mejor las capacidades del formulario superior. El segundo formulario, denominado topMostForm, establece la TopMost propiedad en true para mostrar el formulario como un formulario superior. Cuando se ejecuta este código, al hacer clic en el formulario maximizado no se mostrará el formulario superior por debajo del formulario maximizado. El ejemplo requiere que se llame al método definido en el ejemplo desde otro formulario.

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

Comentarios

Un formulario superior es un formulario que se superpone a todos los demás formularios (no superior), incluso si no es el formulario activo o en primer plano. Los formularios superiores siempre se muestran en el punto más alto en el orden z de las ventanas del escritorio. Puede usar esta propiedad para crear un formulario que siempre se muestra en la aplicación, como una ventana de herramientas Buscar y reemplazar.

Consulte también

• TopLevel