Form.TopLevel Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe ou define um valor que indica se deve ser exibido o formulário como uma janela de nível 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 Propriedade
true para exibir o formulário como uma janela de nível superior; caso contrário, false. A predefinição é true.
- Atributos
Exceções
Um formulário pai de interface de múltiplos documentos (MDI) deve ser uma janela de topo de nível.
Exemplos
O exemplo seguinte usa a Modal propriedade para determinar se uma forma é exibida como uma forma modal. Se não for, as FormBorderStyle propriedades e TopLevel são alteradas para tornar a forma não top-level com uma borda de janela de ferramenta.
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 )
{
// 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)
{
// 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
Observações
Um formulário de topo é uma janela que não tem forma principal, ou cujo formulário pai é a janela do ambiente de trabalho. As janelas de nível superior são tipicamente usadas como a forma principal numa aplicação.