Form.OwnedForms Propriedade

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 de Propriedade

Um array que representa os formulários Form detidos para esta forma.

Atributos

BrowsableAttribute

Exemplos

O exemplo seguinte demonstra como usar a OwnedForms propriedade para modificar todos os formulários pertencentes ao proprietário. O primeiro método no exemplo adiciona formulários ao array de formulários propriedade associados ao formulário próprio. O segundo método percorre todos os formulários possuídos e altera a legenda. Este exemplo exige que ambos os métodos sejam chamados por um evento ou outro método de uma forma.

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

Observações

Esta propriedade devolve um array que contém todas as formas que pertencem a esta forma. Para fazer um formulário pertencente a outro formulário, chame o AddOwnedForm método. O formulário atribuído ao formulário do proprietário permanecerá como propriedade até que o RemoveOwnedForm método seja chamado. Também pode criar um formulário pertencente a outra pessoa, configurando Owner a propriedade com uma referência ao formulário do proprietário.

Quando um formulário pertence a outro formulário, é fechado ou escondido com o formulário proprietário. Por exemplo, considere uma forma nomeada Form2 que pertence a uma forma chamada Form1. Se Form1 for fechado ou minimizado, Form2 também é fechado ou oculto. Formulários de propriedade também nunca são exibidos atrás do formulário de dono. Pode usar formulários de propriedade para janelas, como encontrar e substituir janelas, que não devem ser exibidos atrás do formulário do proprietário quando este for selecionado.

Ver também

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