Form.OwnedForms Form.OwnedForms Form.OwnedForms Form.OwnedForms Property

Определение

Получает массив объектов Form, который представляет все формы, принадлежащие этой форме.Gets an array of Form objects that represent all forms that are owned by this form.

public:
 property cli::array <System::Windows::Forms::Form ^> ^ OwnedForms { cli::array <System::Windows::Forms::Form ^> ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.Form[] OwnedForms { get; }
member this.OwnedForms : System.Windows.Forms.Form[]
Public ReadOnly Property OwnedForms As Form()

Значение свойства

Form[]

Массив Form, который представляет все собственные формы для этой формы.A Form array that represents the owned forms for this form.

Примеры

В следующем примере показано, как использовать OwnedForms свойство для изменения всех форм, принадлежащих форме Owner.The following example demonstrates how to use the OwnedForms property to modify all forms owned by the owner form. Первый метод в примере добавляет формы в массив собственных форм, связанных с собственной формой.The first method in the example adds forms to the array of owned forms associated with the owned form. Второй метод выполняет цикл по всем собственным формам и изменяет заголовок.The second method loops through all owned forms and changes the caption. В этом примере предполагается, что оба метода вызываются событием или другим методом формы.This example requires that both methods are called by an event or other method of a form.

private:
   void AddMyOwnedForm()
   {
      // Create form to be owned.
      Form^ ownedForm = gcnew Form;

      // Set the text of the owned form.
      ownedForm->Text = String::Format( "Owned Form {0}", this->OwnedForms->Length );

      // Add the form to the array of owned forms.
      this->AddOwnedForm( ownedForm );

      // Show the owned form.
      ownedForm->Show();
   }

   void ChangeOwnedFormText()
   {
      // Loop through all owned forms and change their text.
      for ( int x = 0; x < this->OwnedForms->Length; x++ )
      {
         this->OwnedForms[ x ]->Text = String::Format( "My Owned Form {0}", x );
      }
   }
private void AddMyOwnedForm()
{
   // Create form to be owned.
   Form ownedForm = new Form();
   // Set the text of the owned form.
   ownedForm.Text = "Owned Form " + this.OwnedForms.Length;
   // Add the form to the array of owned forms.
   this.AddOwnedForm(ownedForm);
   // Show the owned form.
   ownedForm.Show();
}

private void ChangeOwnedFormText()
{
   // Loop through all owned forms and change their text.
   for (int x = 0; x < this.OwnedForms.Length; x++)
   {
      this.OwnedForms[x].Text = "My Owned Form " + x.ToString();
   }
}
Private Sub AddMyOwnedForm()
   ' Create form to be owned.
   Dim ownedForm As New Form()
   ' Set the text of the owned form.
   ownedForm.Text = "Owned Form " + Me.OwnedForms.Length.ToString()
   ' Add the form to the array of owned forms.
   Me.AddOwnedForm(ownedForm)
   ' Show the owned form.
   ownedForm.Show()
End Sub


Private Sub ChangeOwnedFormText()
   Dim x As Integer
   ' Loop through all owned forms and change their text.
   For x = 0 To (Me.OwnedForms.Length) - 1
      Me.OwnedForms(x).Text = "My Owned Form " + x.ToString()
   Next x
End Sub

Комментарии

Это свойство возвращает массив, содержащий все формы, принадлежащие этой форме.This property returns an array that contains all forms that are owned by this form. Чтобы сделать форму владельцем другой формы, вызовите AddOwnedForm метод.To make a form owned by another form, call the AddOwnedForm method. Форма, назначенная форме Owner, остается владельцем до RemoveOwnedForm вызова метода.The form assigned to the owner form will remain 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 , принадлежащую форме с именем. Form1For 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 will return 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.

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

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