Form.OwnedForms Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Pobiera tablicę Form obiektów reprezentujących wszystkie formularze należące do tego formularza.

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

Wartość właściwości

Form[]

Tablica Form reprezentująca formularze należące do tego formularza.

Atrybuty
BrowsableAttribute

Przykłady

W poniższym przykładzie pokazano, jak używać OwnedForms właściwości do modyfikowania wszystkich formularzy należących do formularza właściciela. Pierwsza metoda w przykładzie dodaje formularze do tablicy formularzy należących do obiektu skojarzonego z formularzem należącym do użytkownika. Druga metoda przechodzi przez wszystkie należące do nich formularze i zmienia podpis. Ten przykład wymaga, aby obie metody zostały wywołane przez zdarzenie lub inną metodę formularza.

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

Uwagi

Ta właściwość zwraca tablicę zawierającą wszystkie formularze należące do tego formularza. Aby utworzyć formularz należący do innego formularza, wywołaj metodę AddOwnedForm . Formularz przypisany do formularza właściciela pozostanie własnością do momentu wywołania RemoveOwnedForm metody . Możesz również utworzyć formularz należący do innego, ustawiając Owner właściwość przy użyciu odwołania do formularza właściciela.

Gdy formularz jest własnością innego formularza, jest zamknięty lub ukryty przy użyciu formularza właściciela. Rozważmy na przykład formularz o nazwie Form2 , który jest własnością formularza o nazwie Form1. Jeśli Form1 jest zamknięty lub zminimalizowany, Form2 jest również zamknięty lub ukryty. Formularze należące do użytkownika nigdy nie są również wyświetlane za ich formularzem właściciela. Możesz użyć formularzy należących do okien, takich jak znajdowanie i zastępowanie okien, które nie powinny być wyświetlane za formularzem właściciela po wybraniu formularza właściciela.

Uwaga

Jeśli formularz jest formularzem nadrzędnym interfejsu wielodokumentowego (MDI), ta właściwość zwróci wszystkie formularze wyświetlane z wyjątkiem wszystkich aktualnie otwartych formularzy podrzędnych MDI. Aby uzyskać formularze podrzędne MDI otwarte w formularzu nadrzędnym MDI, użyj MdiChildren właściwości .

Dotyczy

Zobacz też