Form.TopMost Property

Definition

Obtiene o establece un valor que indica si el formulario debe mostrarse como un formulario de nivel superior.Gets or sets a value indicating whether the form should be displayed as a topmost form.

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

Property Value

Boolean

true para mostrar el formulario como formulario de nivel superior; de lo contrario, false.true to display the form as a topmost form; otherwise, false. De manera predeterminada, es false.The default is false.

Examples

En el ejemplo siguiente se muestra cómo crear un formulario de nivel superior.The following example demonstrates how to create a topmost form. En el ejemplo se crean dos formas, una que está maximizada y otra que se mostrará como un formulario de nivel superior.The example creates two forms, one that is maximized and one that will be displayed as a topmost form. El primer formulario, denominado bottomForm, se muestra maximizado, mediante la propiedad WindowState, para mostrar mejor las capacidades del formulario de nivel superior.The first form, named bottomForm, is displayed maximized, using the WindowState property, to better demonstrate the abilities of the topmost form. La segunda forma, denominada topMostForm, establece la propiedad TopMost en true para mostrar el formulario como un formulario de nivel superior.The second form, named topMostForm, sets the TopMost property to true to display the form as a topmost form. Cuando se ejecute este código, al hacer clic en el formulario maximizado no se mostrará el formulario de nivel superior debajo del formulario maximizado.When this code is run, clicking on the maximized form will not cause the topmost form to be displayed below the maximized form. El ejemplo requiere que se llame al método definido en el ejemplo desde otro formulario.The example requires that the method defined in the example is called from another form.

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

Remarks

Un formulario de nivel superior es un formulario que se superpone a los demás formularios (no de nivel superior), incluso si no es el formulario activo o de primer plano.A topmost form is a form that overlaps all the other (non-topmost) forms even if it is not the active or foreground form. Los formularios de nivel superior siempre se muestran en el punto más alto del orden z de las ventanas del escritorio.Topmost forms are always displayed at the highest point in the z-order of the windows on the desktop. Puede usar esta propiedad para crear un formulario que siempre se muestre en la aplicación, como una ventana de herramientas buscar y reemplazar.You can use this property to create a form that is always displayed in your application, such as a Find and Replace tool window.

Applies to

See also