Form.TopLevel Propiedad

Referencia

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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

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

[System.ComponentModel.Browsable(false)]
public bool TopLevel { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.TopLevel : bool with get, set

Public Property TopLevel As Boolean

Valor de propiedad

Boolean

Es true para mostrar el formulario como ventana de nivel superior; en caso contrario, es false. De manera predeterminada, es true.

Atributos: BrowsableAttribute

Excepciones

Exception

Un formulario MDI (interfaz de múltiples documentos) principal tiene que ser una ventana de nivel superior.

Ejemplos

En el ejemplo siguiente se usa la Modal propiedad para determinar si un formulario se muestra como un formulario modal. Si no es y FormBorderStyle TopLevel las propiedades se cambian para que el formulario no sea de nivel superior con un borde de ventana de herramientas.

private:
   void ShowMyNonModalForm()
   {
      Form^ myForm = gcnew Form;
      myForm->Text = "My Form";
      myForm->SetBounds( 10, 10, 200, 200 );
      myForm->Show();

      // Determine if the form is modal.
      if ( myForm->Modal == false )
      {
         // Change borderstyle and make it not a top level window.
         myForm->FormBorderStyle = ::FormBorderStyle::FixedToolWindow;
         myForm->TopLevel = false;
      }
   }

private void ShowMyNonModalForm()
{
    Form myForm = new Form();
    myForm.Text = "My Form";
    myForm.SetBounds(10,10,200,200);

    myForm.Show();
    // Determine if the form is modal.
    if(myForm.Modal == false)
    {
        // Change borderstyle and make it not a top level window.
        myForm.FormBorderStyle = FormBorderStyle.FixedToolWindow;
        myForm.TopLevel = false;
    }
}

Private Sub ShowMyNonModalForm()
    Dim myForm As New Form()
    myForm.Text = "My Form"
    myForm.SetBounds(10, 10, 200, 200)

    myForm.Show()
    ' Determine if the form is modal.
    If myForm.Modal = False Then
        ' Change borderstyle and make it not a top level window.
        myForm.FormBorderStyle = FormBorderStyle.FixedToolWindow
        myForm.TopLevel = False
    End If
End Sub

Comentarios

Un formulario de nivel superior es una ventana que no tiene ningún formulario primario o cuyo formulario primario es la ventana de escritorio. Las ventanas de nivel superior se suelen usar como formulario principal en una aplicación.

Se aplica a

Consulte también

TopMost