Objek My.Forms

  • Artikel

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

Lihat juga