Form.OwnedForms Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

public:
 property cli::array <System::Windows::Forms::Form ^> ^ OwnedForms { cli::array <System::Windows::Forms::Form ^> ^ get(); };

[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.Form[] OwnedForms { get; }

[<System.ComponentModel.Browsable(false)>]
member this.OwnedForms : System.Windows.Forms.Form[]

Public ReadOnly Property OwnedForms As Form()

Eigenschaftswert

Form[]

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

Attribute: BrowsableAttribute

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die OwnedForms -Eigenschaft verwendet wird, um alle Formulare zu ändern, die dem Besitzerformular gehören. Die erste Methode im Beispiel fügt Dem Array der eigenen Formulare, die dem eigenen Formular zugeordnet sind, Formulare hinzu. Die zweite Methode durchläuft alle eigenen Formulare und ändert die Beschriftung. Dieses Beispiel erfordert, dass beide Methoden von einem Ereignis oder einer anderen Methode eines Formulars aufgerufen werden.

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

Hinweise

Diese Eigenschaft gibt ein Array zurück, das alle Formulare enthält, die diesem Formular gehören. Um ein Formular im Besitz eines anderen Formulars zu machen, rufen Sie die -Methode auf AddOwnedForm . Das dem Besitzerformular zugewiesene Formular bleibt im Besitz, bis die RemoveOwnedForm Methode aufgerufen wird. Sie können auch ein Formular im Besitz eines anderen Formulars erstellen, indem Sie die Owner -Eigenschaft mit einem Verweis auf ihr Besitzerformular festlegen.

Wenn ein Formular im Besitz eines anderen Formulars ist, wird es mit dem Besitzerformular geschlossen oder ausgeblendet. Betrachten Sie beispielsweise ein Formular namens Form2 , das im Besitz eines Formulars mit dem Namen Form1ist. Wenn Form1 geschlossen oder minimiert ist, Form2 wird auch geschlossen oder ausgeblendet. Eigene Formulare werden auch nie hinter ihrem Besitzerformular angezeigt. Sie können eigene Formulare für Fenster verwenden, z. B. Suchen und Ersetzen von Fenstern, die nicht hinter dem Besitzerformular angezeigt werden sollten, wenn das Besitzerformular ausgewählt ist.

Hinweis

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

Gilt für:

Freigeben über