Form.AddOwnedForm(Form) Метод

Определение

Добавляет в эту форму собственную форму.

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)

Параметры

ownedForm
Form

Объект Form, которым будет владеть эта форма.

Примеры

В следующем примере показано, как использовать AddOwnedForm метод для отображения формы в виде собственной формы другой формы. После отображения собственной формы можно свести к минимуму ее форму владельца, а собственная форма будет свернута вместе с ней. В этом примере требуется, чтобы код в примере вызывался из другого события или метода формы.

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

Комментарии

Форма, назначенная форме владельца, остается владельцем до RemoveOwnedForm вызова метода. Вы также можете создать форму, принадлежаемую другой, задав Owner свойство со ссылкой на форму владельца.

Если форма принадлежит другой форме, она закрывается или скрыта с формой владельца. Например, рассмотрим форму с именем Form2 , принадлежащей форме с именем Form1. Если Form1 он закрыт или свернут, Form2 он также закрыт или скрыт. Собственные формы также никогда не отображаются за их формой владельца. Вы можете использовать собственные формы для таких окон, как поиск и замена окон, которые не должны отображаться за формой владельца при выборе формы владельца.

Примечание

Если форма является родительской формой многодокументного интерфейса (MDI), это свойство возвращает все формы, отображаемые за исключением открытых в данный момент дочерних форм MDI. Чтобы получить дочерние формы MDI, открытые в родительской форме MDI, используйте MdiChildren свойство.

Применяется к

См. также раздел