Form.AddOwnedForm-Methode

Fügt diesem Formular als Besitzer ein Formular hinzu.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Sub AddOwnedForm ( _
    ownedForm As Form _
)
'Usage
Dim instance As Form
Dim ownedForm As Form

instance.AddOwnedForm(ownedForm)

public void AddOwnedForm (
    Form ownedForm
)

public:
void AddOwnedForm (
    Form^ ownedForm
)

public void AddOwnedForm (
    Form ownedForm
)

public function AddOwnedForm (
    ownedForm : Form
)

Parameter

• ownedForm
  Die Form, die in den Besitz dieses Formulars übergeht.

Hinweise

Das Besitzerformular bleibt Besitzer des zugewiesenen Formulars, bis die RemoveOwnedForm-Methode aufgerufen wird. Sie können einem Formular auch ein anderes Formular als Besitzer zuweisen, indem Sie die Owner-Eigenschaft mit einem Verweis auf das Besitzerformular festlegen.

Wenn einem Formular ein anderes Formular als Besitzer zugeordnet ist, wird es zusammen mit dem Besitzerformular minimiert und geschlossen. Wenn Form2 z. B. Form1 zugeordnet ist, wird beim Schließen oder Minimieren von Form1 auch Form2 geschlossen bzw. minimiert. Zudem werden Formulare nie hinter dem Besitzerformular angezeigt. Sie können die Formulare eines Besitzerformulars für Fenster wie Fenster zum Suchen und Ersetzen verwenden, die nicht hinter dem Besitzerformular angezeigt werden sollen, wenn das Besitzerformular ausgewählt ist.

Hinweis

Wenn das Formular ein übergeordnetes MDI (Multiple Document Interface)-Formular ist, gibt diese Eigenschaft alle angezeigten Formulare mit Ausnahme der momentan geöffneten untergeordneten MDI-Formulare zurück. Verwenden Sie zum Abrufen der in einem übergeordneten MDI-Formular geöffneten untergeordneten MDI-Formulare die MdiChildren-Eigenschaft.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie mithilfe der AddOwnedForm-Methode ein Formular als Formular mit einem anderen Formular als Besitzer angezeigt wird. Sobald das Formular mit Besitzer angezeigt wird, können Sie das Besitzerformular minimieren, wobei das Formular mit Besitzer ebenfalls minimiert wird. Für das folgende Beispiel ist es erforderlich, dass der Beispielcode über ein anderes Ereignis oder eine andere Methode eines Formulars aufgerufen wird.

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

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:
   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.set_Text("Owned Form");

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

    // Show the owned form.
    ownedForm.Show();
} //ShowMyOwnedForm

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Form-Klasse
Form-Member
System.Windows.Forms-Namespace
OwnedForms
RemoveOwnedForm
Owner