Form.AddOwnedForm(Form) Метод

Определение

Добавляет в эту форму собственную форму.Adds an owned form to this form.

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, которым будет владеть эта форма.The Form that this form will own.

Примеры

В следующем примере показано, как использовать метод AddOwnedForm для отображения формы в качестве собственной формы другой формы.The following example demonstrates how to use the AddOwnedForm method to display a form as an owned form of another form. После отображения собственной формы можно ограничить форму ее владельца, и в ней будет уменьшена ее форма.Once the owned form is shown, you can minimize its owner form and the owned form will minimize with it. В примере требуется, чтобы код в примере вызывался из другого события или метода формы.The example requires that the code in the example is called from another event or method of a form.

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

Комментарии

Форма, назначенная форме Owner, остается владельцем до тех пор, пока не будет вызван метод RemoveOwnedForm.The form assigned to the owner form remains owned until the RemoveOwnedForm method is called. Можно также сделать форму владельцем другой, задав свойству Owner ссылку на форму ее владельца.You can also make a form owned by another by setting the Owner property with a reference to its owner form.

Если форма принадлежит другой форме, она закрывается или скрывается с формой-владельцем.When a form is owned by another form, it is closed or hidden with the owner form. Например, рассмотрим форму с именем Form2, принадлежащей форме с именем Form1.For example, consider a form named Form2 that is owned by a form named Form1. Если Form1 закрыт или свернут, Form2 также закрывается или скрывается.If Form1 is closed or minimized, Form2 is also closed or hidden. Собственные формы также никогда не отображаются позади формы владельца.Owned forms are also never displayed behind their owner form. Можно использовать собственные формы для Windows, такие как поиск и замена окон, которые не должны отображаться позади формы владелец при выборе формы владелец.You can use owned forms for windows such as find and replace windows, which should not be displayed behind the owner form when the owner form is selected.

Примечание

Если форма является родительской формой многодокументного интерфейса (MDI), это свойство возвращает все формы, которые отображаются с исключением всех открытых в данный момент дочерних форм MDI.If the form is a multiple-document interface (MDI) parent form, this property returns all forms that are displayed with the exception of any MDI child forms that are currently open. Чтобы получить дочерние MDI-формы, открытые в родительской форме MDI, используйте свойство MdiChildren.To obtain the MDI child forms opened in an MDI parent form, use the MdiChildren property.

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

Дополнительно