Partager via


Form.AddOwnedForm(Form) Méthode

Définition

Ajoute à ce formulaire un formulaire qu'il détient.

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)

Paramètres

ownedForm
Form

Form qui va appartenir à ce formulaire.

Exemples

L’exemple suivant montre comment utiliser la AddOwnedForm méthode pour afficher un formulaire sous la forme d’un formulaire appartenant à un autre formulaire. Une fois le formulaire détenu affiché, vous pouvez réduire son formulaire propriétaire et le formulaire propriétaire le réduit. L’exemple exige que le code de l’exemple soit appelé à partir d’un autre événement ou méthode d’un formulaire.

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

Remarques

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 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 elle est fermée ou réduite, Form2 elle est également fermée ou masquée. Les formulaires détenus ne sont jamais affichés derrière leur formulaire 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 (Multiple 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é.

S’applique à

Voir aussi