Objek My.Forms
Menyediakan properti untuk mengakses instans setiap formulir Windows yang dideklarasikan dalam proyek saat ini.
Keterangan
Objek My.Forms menyediakan instans setiap formulir dalam proyek saat ini. Nama properti sama dengan nama formulir yang diakses properti.
Anda dapat mengakses formulir yang disediakan oleh objek My.Forms dengan menggunakan nama formulir, tanpa kualifikasi. Karena nama properti sama dengan nama jenis formulir, ini memungkinkan Anda untuk mengakses formulir seolah-olah memiliki instans default. Misalnya, My.Forms.Form1.Show sama dengan Form1.Show.
Objek My.Forms hanya mengekspos formulir yang terkait dengan proyek saat ini. Ini tidak menyediakan akses ke formulir yang dideklarasikan dalam DLL yang direferensikan. Untuk mengakses formulir yang disediakan DLL, Anda harus menggunakan nama formulir yang memenuhi syarat, yang ditulis sebagai DllName.FormName.
Anda dapat menggunakan properti OpenForms untuk mendapatkan koleksi semua formulir terbuka aplikasi.
Objek dan propertinya hanya tersedia untuk aplikasi Windows.
Properti
Setiap properti objek My.Forms menyediakan akses ke instans formulir dalam proyek saat ini. Nama properti sama dengan nama formulir yang diakses properti, dan jenis properti sama dengan jenis formulir.
Catatan
Jika ada nama yang tumpang-tindih, nama properti untuk mengakses formulir adalah RootNamespace_Namespace_FormName. Misalnya, pertimbangkan dua formulir bernama Form1. Jika salah satu formulir ini ada di namespace root WindowsApplication1 dan di namespace Namespace1, Anda akan mengakses formulir tersebut melalui My.Forms.WindowsApplication1_Namespace1_Form1.
Objek My.Forms menyediakan akses ke instans formulir utama aplikasi yang dibuat saat pengaktifan. Untuk semua formulir lain, objek My.Forms membuat instans baru formulir saat diakses dan menyimpannya. Upaya berikutnya untuk mengakses properti tersebut menampilkan instans formulir tersebut.
Anda dapat membuang formulir dengan menetapkan Nothing ke properti untuk formulir tersebut. Pengatur properti memanggil metode Close formulir, lalu menetapkan Nothing ke nilai yang disimpan. Jika Anda menetapkan nilai apa pun selain Nothing ke properti, pengatur akan menampilkan pengecualian ArgumentException.
Anda dapat menguji apakah properti objek My.Forms menyimpan instans formulir dengan menggunakan operator Is atau IsNot. Anda dapat menggunakan operator tersebut untuk memeriksa apakah nilai properti adalah Nothing.
Catatan
Biasanya, operator Is atau IsNot harus membaca nilai properti untuk melakukan perbandingan. Namun, jika properti saat ini menyimpan Nothing, properti membuat instans baru formulir lalu menampilkan instans tersebut. Namun, kompilator Visual Basic memperlakukan properti objek My.Forms secara khusus, dan memungkinkan operator Is atau IsNot untuk memeriksa status properti tanpa mengubah nilainya.
Contoh
Contoh ini mengubah judul formulir SidebarMenu default.
Sub ShowSidebarMenu(ByVal newTitle As String)
If My.Forms.SidebarMenu IsNot Nothing Then
My.Forms.SidebarMenu.Text = newTitle
End If
End Sub
Agar contoh ini berfungsi, proyek Anda harus memiliki formulir bernama SidebarMenu.
Kode ini hanya akan berfungsi di proyek Aplikasi Windows.
Persyaratan
Ketersediaan menurut Jenis Proyek
| Jenis proyek | Tersedia |
|---|---|
| Aplikasi Windows | Ya |
| Pustaka Kelas | No |
| Aplikasi Konsol | No |
| Pustaka Kontrol Windows | No |
| Pustaka Kontrol Web | No |
| Layanan Windows | No |
| Situs Web | No |
