Form.AddOwnedForm(Form) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Aggiunge al form un form secondario.

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)

Parametri

ownedForm
Form

Oggetto Form di cui sarà proprietario questo form.

Esempio

Nell'esempio seguente viene illustrato come usare il AddOwnedForm metodo per visualizzare un modulo come forma di proprietà di un altro modulo. Dopo aver visualizzato il modulo di proprietà, è possibile ridurre al minimo il modulo proprietario e il modulo di proprietà ridurrà al minimo con esso. L'esempio richiede che il codice nell'esempio venga chiamato da un altro evento o metodo di un modulo.

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

Commenti

Il modulo assegnato al modulo proprietario rimane di proprietà fino a quando non viene chiamato il RemoveOwnedForm metodo. È anche possibile creare un modulo di proprietà di un altro impostando la Owner proprietà con un riferimento al relativo modulo proprietario.

Quando un modulo è di proprietà di un altro modulo, viene chiuso o nascosto con il modulo proprietario. Si consideri ad esempio un modulo denominato Form2 di proprietà di un modulo denominato Form1. Se Form1 è chiuso o ridotto al minimo, Form2 viene chiuso o nascosto. I moduli di proprietà non vengono mai visualizzati dietro il modulo proprietario. È possibile usare moduli di proprietà per finestre, ad esempio trovare e sostituire le finestre, che non devono essere visualizzate dietro il modulo proprietario quando viene selezionato il modulo proprietario.

Nota

Se il modulo è un modulo padre MDI (multiple-document Interface), questa proprietà restituisce tutti i moduli visualizzati con l'eccezione di qualsiasi modulo figlio MDI attualmente aperto. Per ottenere i moduli figlio MDI aperti in un modulo padre MDI, usare la MdiChildren proprietà .

Si applica a

Vedi anche