Form.MdiChildren Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origem:

Form.cs

Obtém uma matriz de formulários que representam os formulários filho MDI (interface de vários documentos) que são pai desse formulário.

public:
 property cli::array <System::Windows::Forms::Form ^> ^ MdiChildren { cli::array <System::Windows::Forms::Form ^> ^ get(); };

[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.Form[] MdiChildren { get; }

[<System.ComponentModel.Browsable(false)>]
member this.MdiChildren : System.Windows.Forms.Form[]

Public ReadOnly Property MdiChildren As Form()

Valor da propriedade

Form[]

Uma matriz de Form objetos, cada um dos quais identifica um dos formulários filho MDI deste formulário.

Atributos

BrowsableAttribute

Exemplos

O exemplo a seguir demonstra como usar a MdiChildren propriedade para iterar por meio da lista de formulários filho MDI e adicionar um controle a cada um Button .

private:
   void AddButtonsToMyChildren()
   {
      // If there are child forms in the parent form, add Button controls to them.
      for ( int x = 0; x < this->MdiChildren->Length; x++ )
      {
         // Create a temporary Button control to add to the child form.
         Button^ tempButton = gcnew Button;

         // Set the location and text of the Button control.
         tempButton->Location = Point(10,10);
         tempButton->Text = "OK";

         // Create a temporary instance of a child form (Form 2 in this case).
         Form^ tempChild = dynamic_cast<Form^>(this->MdiChildren[ x ]);

         // Add the Button control to the control collection of the form.
         tempChild->Controls->Add( tempButton );
      }
   }

private void AddButtonsToMyChildren()
{
   // If there are child forms in the parent form, add Button controls to them.
   for (int x =0; x < this.MdiChildren.Length;x++)
   {
      // Create a temporary Button control to add to the child form.
      Button tempButton = new Button();
      // Set the location and text of the Button control.
      tempButton.Location = new Point(10,10);
      tempButton.Text = "OK";
      // Create a temporary instance of a child form (Form 2 in this case).
      Form tempChild = (Form)this.MdiChildren[x];
      // Add the Button control to the control collection of the form.
      tempChild.Controls.Add(tempButton);
   }
}

Private Sub AddButtonsToMyChildren()
    ' If there are child forms in the parent form, add Button controls to them.
    Dim x As Integer
    For x = 0 To (Me.MdiChildren.Length) - 1
        ' Create a temporary Button control to add to the child form.
        Dim tempButton As New Button()
        ' Set the location and text of the Button control.
        tempButton.Location = New Point(10, 10)
        tempButton.Text = "OK"
        ' Create a temporary instance of a child form (Form 2 in this case).
        Dim tempChild As Form = CType(Me.MdiChildren(x), Form)
        ' Add the Button control to the control collection of the form.
        tempChild.Controls.Add(tempButton)
    Next x
End Sub

Comentários

Essa propriedade permite que você obtenha referências a todos os formulários filho MDI atualmente abertos em um formulário pai MDI. 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 para fazer loop em todos os formulários filho MDI para executar operações como salvar dados em um banco de dados quando o formulário pai MDI fechar ou atualizar campos nos formulários filho com base em ações executadas em seu aplicativo.

Confira também

• IsMdiChild
• IsMdiContainer
• MdiParent