Form.OwnedForms Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient un tableau d'objets Form représentant tous les formulaires appartenant à ce formulaire.

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()

Valeur de propriété

Form[]

Tableau Form représentant les formulaires appartenant à ce formulaire.

Attributs

BrowsableAttribute

Exemples

L’exemple suivant montre comment utiliser la OwnedForms propriété pour modifier tous les formulaires appartenant au formulaire propriétaire. La première méthode de l’exemple ajoute des formulaires au tableau des formulaires détenus associés au formulaire détenu. La deuxième méthode effectue une boucle dans tous les formulaires détenus et modifie la légende. Cet exemple nécessite que les deux méthodes soient appelées par un événement ou une autre méthode d’un formulaire.

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

Remarques

Cette propriété retourne un tableau qui contient tous les formulaires appartenant à ce formulaire. Pour créer un formulaire appartenant à un autre formulaire, appelez la AddOwnedForm méthode . Le formulaire affecté au formulaire propriétaire reste détenu jusqu’à ce que la RemoveOwnedForm méthode soit appelée. Vous pouvez également créer un formulaire appartenant à un autre en définissant la Owner propriété avec une référence à son formulaire de propriétaire.

Lorsqu’un formulaire appartient à un autre formulaire, il est fermé ou masqué avec le formulaire propriétaire. Par exemple, considérez un formulaire nommé Form2 qui appartient à un formulaire nommé Form1. Si Form1 est fermé ou réduit, Form2 est également fermé ou masqué. Les formulaires détenus ne sont jamais affichés derrière leur formulaire de propriétaire. Vous pouvez utiliser des formulaires appartenant à des fenêtres telles que rechercher et remplacer des fenêtres, qui ne doivent pas être affichées derrière le formulaire propriétaire lorsque le formulaire propriétaire est sélectionné.

Notes

Si le formulaire est un formulaire parent MDI (Multi-Document Interface), cette propriété renvoie tous les formulaires affichés à l’exception des formulaires enfants MDI actuellement ouverts. Pour obtenir les formulaires enfants MDI ouverts dans un formulaire parent MDI, utilisez la MdiChildren propriété .

Voir aussi

• AddOwnedForm(Form)
• RemoveOwnedForm(Form)
• Owner