Form.OwnedForms Egenskap

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()

Egenskapsvärde

En Form matris som representerar de ägda formulären för det här formuläret.

Attribut

BrowsableAttribute

Exempel

I följande exempel visas hur du använder OwnedForms egenskapen för att ändra alla formulär som ägs av ägarformuläret. Den första metoden i exemplet lägger till formulär i matrisen med ägda formulär som är associerade med det ägda formuläret. Den andra metoden loopar igenom alla ägda formulär och ändrar beskrivningen. Det här exemplet kräver att båda metoderna anropas av en händelse eller annan metod i ett formulär.

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

Kommentarer

Den här egenskapen returnerar en matris som innehåller alla formulär som ägs av det här formuläret. Om du vill skapa ett formulär som ägs av ett annat formulär anropar du AddOwnedForm metoden. Formuläret som tilldelats ägarformuläret förblir ägt tills RemoveOwnedForm metoden anropas. Du kan också skapa ett formulär som ägs av en annan genom att ange Owner egenskapen med en referens till ägarformuläret.

När ett formulär ägs av ett annat formulär stängs det eller döljs med ägarformuläret. Anta till exempel att ett formulär med namnet Form2 ägs av ett formulär med namnet Form1. Om Form1 är stängd eller minimerad, Form2 är också stängd eller dold. Ägda formulär visas inte heller bakom ägarformuläret. Du kan använda ägda formulär för fönster, till exempel hitta och ersätta fönster, som inte ska visas bakom ägarformuläret när ägarformuläret har valts.

Se även

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