Form.OwnedForms-Eigenschaft

Artikel
08/20/2007

Ruft ein Array von Form-Objekten ab, die alle Formulare darstellen, die dieses Formular besitzt.

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

Syntax

'Declaration
Public ReadOnly Property OwnedForms As Form()
'Usage
Dim instance As Form
Dim value As Form()

value = instance.OwnedForms

public Form[] OwnedForms { get; }

public:
property array<Form^>^ OwnedForms {
    array<Form^>^ get ();
}

/** @property */
public Form[] get_OwnedForms ()

public function get OwnedForms () : Form[]

Eigenschaftenwert

Ein Form-Array, das die Formulare darstellt, die dieses Formular besitzt.

Hinweise

Diese Eigenschaft gibt ein Array mit allen Formularen zurück, die dieses Formular besitzt. Um einem Formular ein anderes Formular als Besitzer zuzuweisen, rufen Sie die AddOwnedForm-Methode auf. 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 anhand der OwnedForms-Eigenschaft alle Formulare geändert werden können, deren Besitzer das Besitzerformular ist. Die erste Methode im Beispiel fügt dem Array der Formulare mit Besitzer, das dem Formular mit Besitzer zugeordnet ist, Formulare hinzu. Die zweite Methode durchläuft alle Formulare mit Besitzer und ändert die Beschriftung. Für dieses Beispiel ist es erforderlich, dass beide Methoden durch ein Ereignis oder eine andere Methode in einem Formular aufgerufen werden.

Private Sub AddMyOwnedForm()
   ' Create form to be owned.
   Dim ownedForm As New Form()
   ' Set the text of the owned form.
   ownedForm.Text = "Owned Form " + Me.OwnedForms.Length.ToString()
   ' Add the form to the array of owned forms.
   Me.AddOwnedForm(ownedForm)
   ' Show the owned form.
   ownedForm.Show()
End Sub


Private Sub ChangeOwnedFormText()
   Dim x As Integer
   ' Loop through all owned forms and change their text.
   For x = 0 To (Me.OwnedForms.Length) - 1
      Me.OwnedForms(x).Text = "My Owned Form " + x.ToString()
   Next x
End Sub

private void AddMyOwnedForm()
{
   // Create form to be owned.
   Form ownedForm = new Form();
   // Set the text of the owned form.
   ownedForm.Text = "Owned Form " + this.OwnedForms.Length;
   // Add the form to the array of owned forms.
   this.AddOwnedForm(ownedForm);
   // Show the owned form.
   ownedForm.Show();
}

private void ChangeOwnedFormText()
{
   // Loop through all owned forms and change their text.
   for (int x = 0; x < this.OwnedForms.Length; x++)
   {
      this.OwnedForms[x].Text = "My Owned Form " + x.ToString();
   }
}

private:
   void AddMyOwnedForm()
   {
      // Create form to be owned.
      Form^ ownedForm = gcnew Form;

      // Set the text of the owned form.
      ownedForm->Text = String::Format( "Owned Form {0}", this->OwnedForms->Length );

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

      // Show the owned form.
      ownedForm->Show();
   }

   void ChangeOwnedFormText()
   {
      // Loop through all owned forms and change their text.
      for ( int x = 0; x < this->OwnedForms->Length; x++ )
      {
         this->OwnedForms[ x ]->Text = String::Format( "My Owned Form {0}", x );
      }
   }

private void AddMyOwnedForm()
{
    // Create form to be owned.
    Form ownedForm = new Form();

    // Set the text of the owned form.
    ownedForm.set_Text("Owned Form " + this.get_OwnedForms().length);

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

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

private void ChangeOwnedFormText()
{
    // Loop through all owned forms and change their text.
    for (int x = 0; x < this.get_OwnedForms().length; x++) {
        this.get_OwnedForms()[x].set_Text("My Owned Form " 
            + ((Int32)x).ToString());
    }
} //ChangeOwnedFormText

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
AddOwnedForm
RemoveOwnedForm
Owner

Freigeben über