Form.AddOwnedForm(Form) Método

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Adiciona um formulário pertencente a esse formulário.

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

O Form que esse formulário possuirá.

Exemplos

O exemplo a seguir demonstra como usar o AddOwnedForm método para exibir um formulário como uma forma de propriedade de outro formulário. Depois que o formulário de propriedade for mostrado, você poderá minimizar seu formulário de proprietário e o formulário de propriedade minimizará com ele. O exemplo requer que o código no exemplo seja chamado de outro evento ou método de um formulário.

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

Comentários

O formulário atribuído ao formulário de proprietário permanece 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 nomeado Form2 que pertence a um formulário chamado Form1. Se Form1 estiver fechado ou minimizado, Form2 também será fechado ou oculto. Formulários próprios também nunca são exibidos atrás de seu formulário 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 interface de vários documentos (MDI), 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