Form.AddOwnedForm(Form) Método

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

Agrega un formulario con propietario al formulario.

public:
 void AddOwnedForm(System::Windows::Forms::Form ^ ownedForm);
public void AddOwnedForm (System.Windows.Forms.Form ownedForm);
public void AddOwnedForm (System.Windows.Forms.Form? ownedForm);
member this.AddOwnedForm : System.Windows.Forms.Form -> unit
Public Sub AddOwnedForm (ownedForm As Form)

Parámetros

ownedForm
Form

Form que será propiedad de este formulario.

Ejemplos

En el ejemplo siguiente se muestra cómo usar el AddOwnedForm método para mostrar un formulario como un formulario propiedad de otro formulario. Una vez que se muestre el formulario propiedad, puede minimizar su formulario propietario y el formulario propiedad se minimizará con él. El ejemplo requiere que se llame al código del ejemplo desde otro evento o método de un formulario.

private:
   void ShowMyOwnedForm()
   {
      // Create an instance of the form to be owned.
      Form^ ownedForm = gcnew Form;

      // Set the text of the form to identify it is an owned form.
      ownedForm->Text = "Owned Form";

      // Add ownedForm to array of owned forms.
      this->AddOwnedForm( ownedForm );

      // Show the owned form.
      ownedForm->Show();
   }

private void ShowMyOwnedForm()
{
   // Create an instance of the form to be owned.
   Form ownedForm = new Form();
   // Set the text of the form to identify it is an owned form.
   ownedForm.Text = "Owned Form";
   // Add ownedForm to array of owned forms.
   this.AddOwnedForm(ownedForm);

   // Show the owned form.
   ownedForm.Show();
}

Private Sub ShowMyOwnedForm()
   ' Create an instance of the form to be owned.
   Dim ownedForm As New Form()
   ' Set the text of the form to identify it is an owned form.
   ownedForm.Text = "Owned Form"
   ' Add ownedForm to array of owned forms.
   Me.AddOwnedForm(ownedForm)

   ' Show the owned form.
   ownedForm.Show()
End Sub

Comentarios

El formulario asignado al formulario propietario permanece en propiedad hasta que se llama al RemoveOwnedForm método . También puede crear un formulario propiedad de otro estableciendo la Owner propiedad con una referencia a su formulario propietario.

Cuando un formulario es propiedad de otro formulario, se cierra o oculta con el formulario propietario. Por ejemplo, considere un formulario denominado Form2 que es propiedad de un formulario denominado Form1. Si Form1 está cerrado o minimizado, Form2 también está cerrado o oculto. Los formularios propiedad tampoco se muestran detrás de su formulario de propietario. Puede usar formularios 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 devuelve todos los formularios que se muestran con la excepción de cualquier formulario secundario MDI que esté abierto actualmente. Para obtener los formularios secundarios MDI abiertos en un formulario primario MDI, utilice la MdiChildren propiedad .

Se aplica a

Consulte también