Form.IsMdiContainer Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define um valor que indica se o formulário é um contêiner para formulários filho de interface MDI.

public:
 property bool IsMdiContainer { bool get(); void set(bool value); };

public bool IsMdiContainer { get; set; }

member this.IsMdiContainer : bool with get, set

Public Property IsMdiContainer As Boolean

Valor da propriedade

Boolean

true se o formulário for um contêiner para os formulários filho MDI; caso contrário, false. O padrão é false.

Exemplos

O exemplo a seguir demonstra o uso da IsMdiContainer propriedade, bem como a alteração da BackColor propriedade de um Formulário MDI. Para executar este exemplo, cole o código a seguir em um novo formulário.

// Create a new form.
Form mdiChildForm = new Form();

private void Form1_Load(object sender, System.EventArgs e)
{

    // Set the IsMdiContainer property to true.
    IsMdiContainer = true;

    // Set the child form's MdiParent property to 
    // the current form.
    mdiChildForm.MdiParent = this;

    // Call the method that changes the background color.
    SetBackGroundColorOfMDIForm();
}

private void SetBackGroundColorOfMDIForm()
{
    foreach ( Control ctl in this.Controls )
    {
        if ((ctl) is MdiClient)

            // If the control is the correct type,
            // change the color.
        {
            ctl.BackColor = System.Drawing.Color.PaleGreen;
        }
    }
}

' Create a new form.
Dim mdiChildForm As New Form

Private Sub Form1_Load(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles MyBase.Load

    ' Set the IsMdiContainer property to true.
    IsMdiContainer = True

    ' Set the child form's MdiParent property to 
    ' the current form.
    mdiChildForm.MdiParent = Me

    'Call the method that changes the background color.
    SetBackGroundColorOfMDIForm()
End Sub

Private Sub SetBackGroundColorOfMDIForm()
    Dim ctl As Control

    ' Loop through controls,  
    ' looking for controls of MdiClient type. 
    For Each ctl In Me.Controls
        If TypeOf (ctl) Is MdiClient Then

            ' If the control is the correct type,
            ' change the color.
            ctl.BackColor = System.Drawing.Color.PaleGreen
        End If
    Next

End Sub

Comentários

Essa propriedade altera a exibição e o comportamento do formulário para um formulário pai MDI. Quando essa propriedade é definida como true, o formulário exibe uma área de cliente submersa com uma borda elevada. Todos os formulários filho MDI atribuídos ao formulário pai são exibidos em sua área de cliente.

Quando um formulário pai MDI é fechado, os Closing eventos de todos os formulários filho MDI são gerados antes que o evento do formulário pai da Closing MDI seja gerado. Além disso, os Closed eventos de todos os formulários filho MDI são gerados antes que o Closed evento do formulário pai da MDI seja gerado.

Observação

Se houver dois MenuStrip controles em um formulário filho MDI, a configuração IsMdiContainer como true para 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.

Confira também

• IsMdiChild
• MdiParent
• MdiChildren