Form.AddOwnedForm(Form) Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

Form.cs

Ajoute un formulaire appartenant à ce formulaire.

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

Ce Form formulaire sera propriétaire.

Exemples

L’exemple suivant montre comment utiliser la AddOwnedForm méthode pour afficher un formulaire en tant que formulaire appartenant à un autre formulaire. Une fois que le formulaire appartenant est affiché, vous pouvez réduire son formulaire propriétaire et le formulaire détenu le réduit. L’exemple nécessite 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 pas 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é.

Note

Si le formulaire est un formulaire parent mDI (multiple document interface), cette propriété retourne 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

• OwnedForms
• RemoveOwnedForm(Form)
• Owner