My.Forms – objekt
Poskytuje vlastnosti pro přístup k instanci každého formuláře Windows deklarovaného v aktuálním projektu.
Poznámky
Objekt My.Forms poskytuje instanci každého formuláře v aktuálním projektu. Název vlastnosti je stejný jako název formuláře, ke kterému má vlastnost přístup.
K formulářům, které My.Forms objekt poskytuje, můžete získat přístup pomocí názvu formuláře bez kvalifikace. Vzhledem k tomu, že název vlastnosti je stejný jako název typu formuláře, umožňuje přístup k formuláři, jako by měl výchozí instanci. Například My.Forms.Form1.Show je ekvivalentní s Form1.Show.
Objekt My.Forms zveřejňuje pouze formuláře přidružené k aktuálnímu projektu. Neposkytuje přístup k formulářům deklarovaným v odkazovaných knihovnách DLL. Chcete-li získat přístup k formuláři, který poskytuje knihovna DLL, je nutné použít kvalifikovaný název formuláře napsaný jako DllName.FormName.
Vlastnost můžete použít OpenForms k získání kolekce všech otevřených formulářů aplikace.
Objekt a jeho vlastnosti jsou k dispozici pouze pro aplikace systému Windows.
Vlastnosti
Každá vlastnost objektu My.Forms poskytuje přístup k instanci formuláře v aktuálním projektu. Název vlastnosti je stejný jako název formuláře, ke kterému vlastnost přistupuje, a typ vlastnosti je stejný jako typ formuláře.
Poznámka:
Pokud dojde ke kolizi názvu, název vlastnosti pro přístup k formuláři je RootNamespace_Namespace_FormName. Představte si například dvě formuláře pojmenované Form1.Pokud je jeden z těchto formulářů v kořenovém oboru názvů WindowsApplication1 a v oboru názvů Namespace1, budete k ho přistupovat prostřednictvím My.Forms.WindowsApplication1_Namespace1_Form1.
Objekt My.Forms poskytuje přístup k instanci hlavního formuláře aplikace, který byl vytvořen při spuštění. Pro všechny ostatní formuláře My.Forms objekt vytvoří novou instanci formuláře při přístupu a uloží ho. Následné pokusy o přístup k této vlastnosti vrátí danou instanci formuláře.
Formulář můžete odstranit přiřazením Nothing vlastnosti tohoto formuláře. Vlastnost setter volá Close metodu formuláře a pak přiřadí Nothing uloženou hodnotu. Pokud přiřadíte jinou hodnotu než Nothing vlastnost, vyvolá setter ArgumentException výjimku.
Pomocí operátoru IsNot nebo operátoru můžete otestovat, zda vlastnost objektu My.Forms ukládá instanci formulářeIs. Tyto operátory můžete použít ke kontrole, zda je Nothinghodnota vlastnosti .
Poznámka:
Obvykle Is musí operátor IsNot číst hodnotu vlastnosti k provedení porovnání. Pokud však vlastnost aktuálně ukládá Nothing, vlastnost vytvoří novou instanci formuláře a pak vrátí tuto instanci. Kompilátor jazyka Visual Basic však zachází s vlastnostmi My.Forms objektu odlišně a umožňuje Is nebo IsNot operátor kontrolovat stav vlastnosti beze změny jeho hodnoty.
Příklad
Tento příklad změní název výchozího SidebarMenu formuláře.
Sub ShowSidebarMenu(ByVal newTitle As String)
If My.Forms.SidebarMenu IsNot Nothing Then
My.Forms.SidebarMenu.Text = newTitle
End If
End Sub
Aby tento příklad fungoval, musí mít váš projekt formulář s názvem SidebarMenu.
Tento kód bude fungovat pouze v projektu aplikace systému Windows.
Požadavky
Dostupnost podle typu projektu
| Typ projektu | dostupný |
|---|---|
| Aplikace pro systém Windows | Ano |
| Knihovna tříd | No |
| Konzolová aplikace | No |
| Knihovna ovládacích prvků systému Windows | No |
| Knihovna webových ovládacích prvků | No |
| Služba systému Windows | No |
| Web | No |
