Form.AddOwnedForm(Form) Metoda

Definicja

Dodaje formularz własności do tego formularza.

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)

Parametry

ownedForm
Form

Ten Form formularz będzie właścicielem.

Przykłady

W poniższym przykładzie pokazano, jak używać AddOwnedForm metody do wyświetlania formularza jako formularza należącego do innego formularza. Po wyświetlaniu formularza należącego można zminimalizować jego formularz właściciela, a formularz należący do niego będzie zminimalizowany. Przykład wymaga wywołania kodu w przykładzie z innego zdarzenia lub metody formularza.

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

Uwagi

Formularz przypisany do formularza właściciela pozostaje własnością do momentu wywołania RemoveOwnedForm metody. Możesz również utworzyć formularz należący do innego, ustawiając Owner właściwość z odwołaniem do formularza właściciela.

Gdy formularz jest własnością innego formularza, jest zamknięty lub ukryty w formularzu właściciela. Rozważmy na przykład formularz o nazwie Form2 , który jest własnością formularza o nazwie Form1. Jeśli Form1 jest zamknięty lub zminimalizowany, Form2 jest również zamknięty lub ukryty. Formularze własności nigdy nie są również wyświetlane za formularzem właściciela. Możesz używać formularzy należących do okien, takich jak znajdowanie i zastępowanie okien, które nie powinny być wyświetlane za formularzem właściciela po wybraniu formularza właściciela.

Uwaga

Jeśli formularz jest formularzem nadrzędnym interfejsu wielodokumentowego (MDI), ta właściwość zwraca wszystkie formularze wyświetlane z wyjątkiem wszystkich formularzy podrzędnych MDI, które są obecnie otwarte. Aby uzyskać formularze podrzędne MDI otwarte w formularzu nadrzędnym MDI, użyj MdiChildren właściwości .

Dotyczy

Zobacz też