Form.OwnedForms Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Получает массив объектов 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; }

[<System.ComponentModel.Browsable(false)>]
member this.OwnedForms : System.Windows.Forms.Form[]

Public ReadOnly Property OwnedForms As Form()

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

Form[]

Массив Form, который представляет все собственные формы для этой формы.

Атрибуты

BrowsableAttribute

Примеры

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

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

Комментарии

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

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

Примечание

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

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

• AddOwnedForm(Form)
• RemoveOwnedForm(Form)
• Owner