Form.OwnedForms Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan array Form objek yang mewakili semua formulir yang dimiliki oleh formulir ini.
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()Nilai Properti
Array Form yang mewakili formulir yang dimiliki untuk formulir ini.
- Atribut
Contoh
Contoh berikut menunjukkan cara menggunakan OwnedForms properti untuk memodifikasi semua formulir yang dimiliki oleh formulir pemilik. Metode pertama dalam contoh menambahkan formulir ke array formulir yang dimiliki yang terkait dengan formulir yang dimiliki. Metode kedua mengulangi semua formulir yang dimiliki dan mengubah keterangan. Contoh ini mengharuskan kedua metode dipanggil oleh peristiwa atau metode formulir lainnya.
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
Keterangan
Properti ini mengembalikan array yang berisi semua formulir yang dimiliki oleh formulir ini. Untuk membuat formulir yang dimiliki oleh formulir lain, panggil AddOwnedForm metode . Formulir yang ditetapkan ke formulir pemilik akan tetap dimiliki sampai metode dipanggil RemoveOwnedForm . Anda juga dapat membuat formulir yang dimiliki oleh yang lain dengan mengatur Owner properti dengan referensi ke formulir pemiliknya.
Ketika formulir dimiliki oleh formulir lain, formulir ditutup atau disembunyikan dengan formulir pemilik. Misalnya, pertimbangkan formulir bernama Form2 yang dimiliki oleh formulir bernama Form1. Jika Form1 ditutup atau diminimalkan, Form2 juga ditutup atau disembunyikan. Formulir yang dimiliki juga tidak pernah ditampilkan di belakang formulir pemiliknya. Anda dapat menggunakan formulir yang dimiliki untuk jendela seperti temukan dan ganti jendela, yang seharusnya tidak ditampilkan di belakang formulir pemilik ketika formulir pemilik dipilih.
Nota
Jika formulir adalah formulir induk antarmuka multi-dokumen (MDI), properti ini akan mengembalikan semua formulir yang ditampilkan dengan pengecualian formulir turunan MDI apa pun yang saat ini terbuka. Untuk mendapatkan formulir turunan MDI yang dibuka dalam formulir induk MDI, gunakan MdiChildren properti .
