Form.IsMdiContainer Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft einen Wert ab, der angibt, ob das Formular ein Container für untergeordnete MDI (Multiple Document Interface)-Formulare ist, oder legt diesen fest.

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

Eigenschaftswert

Boolean

true, wenn das Formular ein Container für untergeordnete MDI-Formulare ist, andernfalls false. Der Standardwert ist false.

Beispiele

Das folgende Beispiel veranschaulicht die Verwendung der IsMdiContainer -Eigenschaft sowie das Ändern der BackColor Eigenschaft eines MDI-Formulars. Fügen Sie zum Ausführen dieses Beispiels den folgenden Code in eine neue Form ein.

// 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

Hinweise

Diese Eigenschaft ändert die Anzeige und das Verhalten des Formulars in ein übergeordnetes MDI-Formular. Wenn diese Eigenschaft auf truefestgelegt ist, zeigt das Formular einen gesunkenen Clientbereich mit einem erhöhten Rahmen an. Alle untergeordneten MDI-Formulare, die dem übergeordneten Formular zugewiesen sind, werden im Clientbereich angezeigt.

Wenn ein übergeordnetes MDI-Formular geschlossen wird, werden die Closing Ereignisse aller untergeordneten MDI-Formulare ausgelöst, bevor das Ereignis des übergeordneten MDI-Formulars Closing ausgelöst wird. Darüber hinaus werden die Closed Ereignisse aller untergeordneten MDI-Formulare ausgelöst, bevor das Closed Ereignis des übergeordneten MDI-Formulars ausgelöst wird.

Hinweis

Wenn in einem untergeordneten MDI-Formular zwei MenuStrip Steuerelemente vorhanden sind, führt die Einstellung IsMdiContainer auf true für das übergeordnete Formular den Inhalt nur eines der MenuStrip Steuerelemente zusammen. Verwenden Sie Merge , um den Inhalt zusätzlicher untergeordneter MenuStrip Steuerelemente im übergeordneten MDI-Formular zusammenzuführen.

Weitere Informationen

• IsMdiChild
• MdiParent
• MdiChildren