Form.OwnedForms Свойство

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

Form.cs

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