Compartilhar via


Form.OwnedForms Propriedade

Definição

Obtém uma matriz de objetos Form que representam todos os formulários pertencentes a esse formulário.

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()

Valor da propriedade

Form[]

Uma matriz Form que representa os formulários pertencentes a esse formulário.

Atributos

Exemplos

O exemplo a seguir demonstra como usar a OwnedForms propriedade para modificar todos os formulários pertencentes ao formulário de proprietário. O primeiro método no exemplo adiciona formulários à matriz de formulários de propriedade associados ao formulário de propriedade. O segundo método percorre todos os formulários próprios e altera a legenda. Este exemplo exige que ambos os métodos sejam chamados por um evento ou outro método de um formulário.

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

Comentários

Essa propriedade retorna uma matriz que contém todos os formulários pertencentes a esse formulário. Para criar um formulário de propriedade de outro formulário, chame o AddOwnedForm método . O formulário atribuído ao formulário de proprietário permanecerá de propriedade até que o RemoveOwnedForm método seja chamado. Você também pode criar um formulário de propriedade de outro definindo a Owner propriedade com uma referência ao formulário de proprietário.

Quando um formulário pertence a outro formulário, ele é fechado ou oculto com o formulário de proprietário. Por exemplo, considere um formulário chamado Form2 que pertence a um formulário chamado Form1. Se Form1 estiver fechado ou minimizado, Form2 também será fechado ou oculto. Formulários de propriedade também nunca são exibidos por trás de seu formulário de proprietário. Você pode usar formulários de propriedade para janelas como localizar e substituir janelas, que não devem ser exibidas atrás do formulário de proprietário quando o formulário de proprietário é selecionado.

Observação

Se o formulário for um formulário pai de MDI (interface de vários documentos), essa propriedade retornará todos os formulários exibidos com exceção de qualquer formulário filho MDI que esteja aberto no momento. Para obter os formulários filho MDI abertos em um formulário pai MDI, use a MdiChildren propriedade .

Aplica-se a

Confira também