Form.AddOwnedForm(Form) Methode

Definition

Fügt diesem Formular als Besitzer ein Formular hinzu.

public:
 void AddOwnedForm(System::Windows::Forms::Form ^ ownedForm);
public void AddOwnedForm (System.Windows.Forms.Form ownedForm);
public void AddOwnedForm (System.Windows.Forms.Form? ownedForm);
member this.AddOwnedForm : System.Windows.Forms.Form -> unit
Public Sub AddOwnedForm (ownedForm As Form)

Parameter

ownedForm
Form

Das Form-Objekt, das in den Besitz dieses Formulars übergeht.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie mithilfe der AddOwnedForm Methode ein Formular als eigene Form eines anderen Formulars anzeigen können. Sobald das eigene Formular angezeigt wird, können Sie das Besitzerformular minimieren und das eigene Formular minimiert. Das Beispiel erfordert, dass der Code im Beispiel aus einem anderen Ereignis oder einer anderen Methode eines Formulars aufgerufen wird.

private:
   void ShowMyOwnedForm()
   {
      // Create an instance of the form to be owned.
      Form^ ownedForm = gcnew Form;

      // Set the text of the form to identify it is an owned form.
      ownedForm->Text = "Owned Form";

      // Add ownedForm to array of owned forms.
      this->AddOwnedForm( ownedForm );

      // Show the owned form.
      ownedForm->Show();
   }
private void ShowMyOwnedForm()
{
   // Create an instance of the form to be owned.
   Form ownedForm = new Form();
   // Set the text of the form to identify it is an owned form.
   ownedForm.Text = "Owned Form";
   // Add ownedForm to array of owned forms.
   this.AddOwnedForm(ownedForm);

   // Show the owned form.
   ownedForm.Show();
}
Private Sub ShowMyOwnedForm()
   ' Create an instance of the form to be owned.
   Dim ownedForm As New Form()
   ' Set the text of the form to identify it is an owned form.
   ownedForm.Text = "Owned Form"
   ' Add ownedForm to array of owned forms.
   Me.AddOwnedForm(ownedForm)

   ' Show the owned form.
   ownedForm.Show()
End Sub

Hinweise

Das Formular, das dem Besitzerformular zugewiesen ist, ist bis zum Aufrufen der RemoveOwnedForm Methode im Besitz. Sie können auch ein Formular im Besitz eines anderen Formulars erstellen, indem Sie die Owner Eigenschaft mit einem Verweis auf das Besitzerformular festlegen.

Wenn ein Formular im Besitz eines anderen Formulars ist, wird es mit dem Besitzerformular geschlossen oder ausgeblendet. Ziehen Sie z. B. ein Formular mit dem Namen Form2 eines Formulars mit dem Namen " Form1. Wenn Form1 sie geschlossen oder minimiert ist, Form2 ist es auch geschlossen oder ausgeblendet. Eigene Formulare werden auch nie hinter ihrem Besitzerformular angezeigt. Sie können eigene Formulare für Fenster wie Suchen und Ersetzen von Fenstern verwenden, die beim Auswählen des Besitzerformulars nicht hinter dem Besitzerformular angezeigt werden sollen.

Hinweis

Wenn es sich bei dem Formular um ein übergeordnetes MDI-Formular (Multiple-Document Interface, MDI) handelt, gibt diese Eigenschaft alle Formulare zurück, die mit Ausnahme aller derzeit geöffneten MDI-untergeordneten Formulare angezeigt werden. Verwenden Sie die MdiChildren Eigenschaft, um die untergeordneten MDI-Formulare abzurufen, die in einem übergeordneten MDI-Formular geöffnet wurden.

Gilt für

Siehe auch