Form.OwnedForms Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Získá pole Form objektů, které představují všechny formuláře, které jsou ve vlastnictví tohoto formuláře.

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

Hodnota vlastnosti

Form[]

Pole Form , které představuje vlastněné formuláře pro tento formulář.

Atributy

BrowsableAttribute

Příklady

Následující příklad ukazuje, jak použít OwnedForms vlastnost k úpravě všech formulářů vlastněných formulářem vlastníka. První metoda v příkladu přidá formuláře do pole vlastněných formulářů přidružených k vlastněným formulářům. Druhá metoda prochází všechny vlastněné formuláře a změní titulek. Tento příklad vyžaduje, aby obě metody byly volána událostí nebo jinou metodou formuláře.

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

Poznámky

Tato vlastnost vrátí pole, které obsahuje všechny formuláře vlastněné tímto formulářem. Chcete-li vytvořit formulář vlastněný jiným formulářem, zavolejte metodu AddOwnedForm . Formulář přiřazený formuláři vlastníka zůstane ve vlastnictví, dokud RemoveOwnedForm se metoda nevolá. Formulář můžete také nastavit jako vlastníka jiného formuláře nastavením Owner vlastnosti s odkazem na formulář vlastníka.

Pokud je formulář vlastněný jiným formulářem, je zavřený nebo skrytý s formulářem vlastníka. Představte si například formulář s názvem Form2 , který vlastní formulář s názvem Form1. Pokud Form1 je zavřený nebo minimalizovaný, Form2 je také zavřený nebo skrytý. Formuláře ve vlastnictví se také nikdy nezobrazují za formulářem vlastníka. Vlastní formuláře můžete použít pro okna, například najít a nahradit okna, které by se při výběru formuláře vlastníka neměly zobrazovat za formulářem vlastníka.

Poznámka

Pokud je formulář nadřazeným formulářem rozhraní MDI (Multiple Document Interface), vrátí tato vlastnost všechny formuláře, které jsou zobrazeny s výjimkou podřízených formulářů MDI, které jsou aktuálně otevřeny. Chcete-li získat podřízené formuláře MDI otevřené v nadřazené formuláři MDI, použijte MdiChildren vlastnost .

Viz také

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