Form.OwnedForms Propiedad

Definición

Obtiene una matriz de objetos Form que representa todos los formularios que posee dicho formulario.

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 propiedad

Form[]

Matriz de Form que representa los formularios que posee dicho formulario.

Atributos

Ejemplos

En el ejemplo siguiente se muestra cómo usar la OwnedForms propiedad para modificar todos los formularios que pertenecen al formulario propietario. El primer método del ejemplo agrega formularios a la matriz de formularios propiedad asociados al formulario propiedad. El segundo método recorre en bucle todos los formularios de propiedad y cambia el título. En este ejemplo se requiere que un evento u otro método de un formulario llamen a ambos métodos.

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

Comentarios

Esta propiedad devuelve una matriz que contiene todos los formularios que pertenecen a este formulario. Para que un formulario sea propiedad de otro formulario, llame al AddOwnedForm método . El formulario asignado al formulario de propietario permanecerá en propiedad hasta que se llame al RemoveOwnedForm método . También puede hacer que un formulario sea propiedad de otro estableciendo la Owner propiedad con una referencia a su formulario propietario.

Cuando un formulario es propiedad de otro formulario, se cierra u oculta con el formulario propietario. Por ejemplo, considere un formulario denominado Form2 que pertenece a un formulario denominado Form1. Si Form1 está cerrado o minimizado, Form2 también está cerrado o oculto. Los formularios propiedad también se muestran nunca detrás de su formulario de propietario. Puede usar formularios de propiedad para ventanas como buscar y reemplazar ventanas, que no deben mostrarse detrás del formulario de propietario cuando se selecciona el formulario de propietario.

Nota

Si el formulario es un formulario primario de interfaz de varios documentos (MDI), esta propiedad devolverá todos los formularios que se muestran con la excepción de los formularios secundarios MDI que están abiertos actualmente. Para obtener los formularios secundarios MDI abiertos en un formulario primario MDI, use la MdiChildren propiedad .

Se aplica a

Consulte también