Form.AddOwnedForm(Form) Méthode

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

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

S’applique à

Voir aussi

• OwnedForms
• RemoveOwnedForm(Form)
• Owner