Form.MdiChildren Form.MdiChildren Form.MdiChildren Form.MdiChildren Property

Definición

Obtiene una matriz de formularios que representan los formularios MDI (interfaz de múltiples documentos) secundarios que actúan como primarios de este formulario.Gets an array of forms that represent the multiple-document interface (MDI) child forms that are parented to this form.

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; }
member this.MdiChildren : System.Windows.Forms.Form[]
Public ReadOnly Property MdiChildren As Form()

Valor de propiedad

Form[]

Matriz de objetos Form, cada uno de los cuales identifica a uno de los formularios MDI secundarios de este formulario.An array of Form objects, each of which identifies one of this form's MDI child forms.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el MdiChildren propiedad para recorrer en iteración la lista de formularios MDI secundarios y agregar un Button control a cada uno.The following code example demonstrates how to use the MdiChildren property to iterate through the list of MDI child forms and add a Button control to each.

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 'AddButtonsToMyChildren

Comentarios

Esta propiedad permite obtener referencias a todos los formularios secundarios MDI abiertos actualmente en un formulario primario MDI.This property allows you to obtain references to all the MDI child forms currently opened in an MDI parent form. Para crear un formulario MDI secundario, asigne el Form que será el formulario MDI principal a la MdiParent propiedad del formulario secundario.To create an MDI child form, assign the Form that will be the MDI parent form to the MdiParent property of the child form.

Puede utilizar esta propiedad para recorrer en iteración todos los formularios MDI secundarios para realizar operaciones como guardar los datos en una base de datos cuando se cierra el formulario MDI principal o para actualizar los campos en los formularios secundarios en función de las acciones realizadas en la aplicación.You can use this property to loop through all the MDI child forms to perform operations such as saving data to a database when the MDI parent form closes or to update fields on the child forms based on actions performed in your application.

Se aplica a

Consulte también: