Form.TopLevel Form.TopLevel Form.TopLevel Form.TopLevel Property

Определение

Возвращает или задает значение, определяющее режим отображения формы в качестве окна верхнего уровня.Gets or sets a value indicating whether to display the form as a top-level window.

public:
 property bool TopLevel { bool get(); void set(bool value); };
[System.ComponentModel.Browsable(false)]
public bool TopLevel { get; set; }
member this.TopLevel : bool with get, set
Public Property TopLevel As Boolean

Значение свойства

true для отображения формы в качестве окна верхнего уровня; в противном случае — false.true to display the form as a top-level window; otherwise, false. Значение по умолчанию — true.The default is true.

Исключения

Необходимо, чтобы родительская MDI-форма являлась окном верхнего уровня.A Multiple-document interface (MDI) parent form must be a top-level window.

Примеры

В следующем примере Modal свойство используется для определения, отображается ли форма как модальная форма.The following example use the Modal property to determine if a form is displayed as a modal form. Если это не FormBorderStyle так, свойства TopLevel и изменяются, чтобы форма не стала формой верхнего уровня с границей окна инструментов.If it is not the FormBorderStyle and TopLevel properties are changed to make the form non-top-level form with a tool window border.

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

Комментарии

Форма верхнего уровня — это окно, не имеющее родительской формы или родительской формы которого является окном рабочего стола.A top-level form is a window that has no parent form, or whose parent form is the desktop window. Окна верхнего уровня обычно используются в качестве основной формы в приложении.Top-level windows are typically used as the main form in an application.

Применяется к

Дополнительно