My.Forms objektum
Tulajdonságokat biztosít az aktuális projektben deklarált egyes Windows-űrlapok egy példányának eléréséhez.
Megjegyzések
Az My.Forms objektum az aktuális projekt minden űrlapjának egy-egy példányát biztosítja. A tulajdonság neve megegyezik a tulajdonság által elért űrlap nevével.
Az objektum által biztosított űrlapokat az My.Forms űrlap nevének használatával, képesítés nélkül érheti el. Mivel a tulajdonság neve megegyezik az űrlap típusnevével, így úgy érhet el egy űrlapot, mintha alapértelmezett példánya lenne. Például a My.Forms.Form1.Show egyenértékű a következővel: Form1.Show.
Az My.Forms objektum csak az aktuális projekthez társított űrlapokat teszi elérhetővé. Nem biztosít hozzáférést a hivatkozott DLL-ekben deklarált űrlapokhoz. A DLL által biztosított űrlap eléréséhez az űrlap dllName néven írt minősített nevét kell használnia.FormName.
A tulajdonság használatával OpenForms lekérheti az alkalmazás összes megnyitott űrlapjának gyűjteményét.
Az objektum és tulajdonságai csak Windows-alkalmazásokhoz érhetők el.
Tulajdonságok
Az objektum minden tulajdonsága My.Forms hozzáférést biztosít egy űrlap egy példányához az aktuális projektben. A tulajdonság neve megegyezik a tulajdonság által elért űrlap nevével, a tulajdonság típusa pedig megegyezik az űrlap típusával.
Feljegyzés
Ha névütközés történik, az űrlaphoz való hozzáférés tulajdonságneve a RootNamespace_Namespace_FormName. Vegyük például két űrlap nevét Form1., ha az űrlapok egyike a gyökérnévtérben és a névtérben WindowsApplication1Namespace1található, akkor az űrlapot a rendszer a következő módon érheti el My.Forms.WindowsApplication1_Namespace1_Form1:
Az My.Forms objektum hozzáférést biztosít az alkalmazás indításkor létrehozott fő űrlapjának példányához. Minden más űrlap esetében az My.Forms objektum létrehoz egy új példányt az űrlaphoz, amikor hozzáfér, és tárolja azt. A tulajdonság elérésére tett későbbi kísérletek az űrlap adott példányát adja vissza.
Az űrlapokat az űrlap tulajdonságához rendelve Nothing helyezheti el. A tulajdonságválasztó meghívja az Close űrlap metódusát, majd hozzárendeli Nothing a tárolt értékhez. Ha a tulajdonságtól Nothing eltérő értéket rendel hozzá, a beállító kivételt ArgumentException jelez.
Tesztelheti, hogy az My.Forms objektum egy tulajdonsága tárolja-e az űrlap egy példányát az vagy IsNot az Is operátor használatával. Ezekkel az operátorokkal ellenőrizheti, hogy a tulajdonság értéke .Nothing
Feljegyzés
Az összehasonlítás elvégzéséhez általában az vagy IsNot az Is operátornak be kell olvasnia a tulajdonság értékét. Ha azonban a tulajdonság jelenleg tárolódik Nothing, a tulajdonság létrehoz egy új űrlappéldányt, majd visszaadja azt. A Visual Basic fordító azonban másképp kezeli az My.Forms objektum tulajdonságait, és lehetővé teszi, hogy az IsIsNot operátor az érték módosítása nélkül ellenőrizze a tulajdonság állapotát.
Példa
Ez a példa módosítja az alapértelmezett SidebarMenu űrlap címét.
Sub ShowSidebarMenu(ByVal newTitle As String)
If My.Forms.SidebarMenu IsNot Nothing Then
My.Forms.SidebarMenu.Text = newTitle
End If
End Sub
Ahhoz, hogy ez a példa működjön, a projektnek tartalmaznia kell egy űrlapot.SidebarMenu
Ez a kód csak Windows-alkalmazásprojektekben működik.
Követelmények
Rendelkezésre állás projekttípus szerint
| Projekttípus | Rendelkezésre áll |
|---|---|
| Windows-alkalmazás | Igen |
| Osztálytár | Nem |
| Konzolalkalmazás | Nem |
| Windows-vezérlőtár | Nem |
| Webvezérlő-kódtár | Nem |
| Windows-szolgáltatás | Nem |
| Webhely | Nem |
