Form.MdiParent Propriedade

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtém ou define o atual formulário pai da interface MDI deste formulário.

public:
 property System::Windows::Forms::Form ^ MdiParent { System::Windows::Forms::Form ^ get(); void set(System::Windows::Forms::Form ^ value); };
[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.Form MdiParent { get; set; }
[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.Form? MdiParent { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.MdiParent : System.Windows.Forms.Form with get, set
Public Property MdiParent As Form

Valor da propriedade

Form

Um Form que representa o formulário pai da MDI.

Atributos
BrowsableAttribute

Exceções

Exception

O Form atribuído a essa propriedade não está marcado como um contêiner MDI.

- ou - O Form atribuído a essa propriedade é um filho e um formulário de contêiner MDI.

- ou - O Form atribuído a essa propriedade está localizado em um thread diferente.

Exemplos

O exemplo a seguir demonstra como criar formulários filho em um aplicativo MDI. O código de exemplo cria um formulário com texto exclusivo para identificar o formulário filho. O exemplo usa a MdiParent propriedade para especificar que um formulário é um formulário filho. Este exemplo exige que o código no exemplo seja chamado de um formulário que tenha sua IsMdiContainer propriedade definida true e que o formulário tenha uma variável inteiro de nível privado chamada childCount.

private:
   void CreateMyChildForm()
   {
      // Create a new form to represent the child form.
      Form^ child = gcnew Form;

      // Increment the private child count.
      childCount++;

      // Set the text of the child form using the count of child forms.
      String^ formText = String::Format( "Child {0}", childCount );
      child->Text = formText;

      // Make the new form a child form.
      child->MdiParent = this;

      // Display the child form.
      child->Show();
   }

private void CreateMyChildForm ()
{
   // Create a new form to represent the child form.
   Form child = new Form();
   // Increment the private child count.
   childCount++;
   // Set the text of the child form using the count of child forms.
   String formText = "Child " + childCount;
   child.Text = formText;

   // Make the new form a child form.
   child.MdiParent = this;
   // Display the child form.
   child.Show();
}

Private Sub CreateMyChildForm()
   ' Create a new form to represent the child form.
   Dim child As New Form()
   ' Increment the private child count.
   childCount += 1
   ' Set the text of the child form using the count of child forms.
   Dim formText As String = "Child " + childCount.ToString()
   child.Text = formText

   ' Make the new form a child form.
   child.MdiParent = Me
   ' Display the child form.
   child.Show()
End Sub

Comentários

Para criar um formulário filho MDI, atribua o Form formulário pai do MDI à MdiParent propriedade do formulário filho. Você pode usar essa propriedade de um formulário filho MDI para obter informações globais de que todos os formulários filho precisam ou para invocar métodos que executam ações para todos os formulários filho.

Observação

Se houver dois MenuStrip controles em um formulário filho MDI, a configuração IsMdiContainer para true o formulário pai mescla o conteúdo de apenas um dos MenuStrip controles. Use Merge para mesclar o conteúdo de controles filho MenuStrip adicionais no formulário pai do MDI.

Aplica-se a

Confira também