Form.MdiParent Eigenschaft

  • Referenz

Definition

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

Ruft das aktuelle übergeordnete MDI (Multiple Document Interface)-Formular für dieses Formular ab oder legt dieses fest.

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

Eigenschaftswert

Form

Ein Form-Objekt, das das übergeordnete MDI-Formular darstellt.

Attribute
BrowsableAttribute

Ausnahmen

Exception

Die dieser Eigenschaft zugewiesene Form ist nicht als MDI-Container gekennzeichnet.

- oder - Die dieser Eigenschaft zugewiesene Form ist gleichzeitig untergeordnetes Formular und MDI-Containerformular.

- oder - Die dieser Eigenschaft zugewiesene Form befindet sich in einem anderen Thread.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie untergeordnete Formulare in einer MDI-Anwendung erstellt werden. Der Beispielcode erstellt ein Formular mit eindeutigem Text, um das untergeordnete Formular zu identifizieren. Im Beispiel wird die MdiParent Eigenschaft verwendet, um anzugeben, dass ein Formular ein untergeordnetes Formular ist. In diesem Beispiel wird der Code im Beispiel aus einem Formular aufgerufen, auf das seine IsMdiContainer Eigenschaft festgelegt true ist und dass das Formular eine ganze Zahl auf privater Klassenebene mit dem Namen childCount"Ganzzahl" aufweist.

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

Hinweise

Weisen Sie zum Erstellen eines untergeordneten MDI-Formulars Form das übergeordnete MDI-Formular der MdiParent Eigenschaft des untergeordneten Formulars zu. Sie können diese Eigenschaft aus einem MDI-untergeordneten Formular verwenden, um globale Informationen zu erhalten, die alle untergeordneten Formulare benötigen oder Methoden aufrufen, die Aktionen für alle untergeordneten Formulare ausführen.

Hinweis

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

Gilt für

Siehe auch