My.Forms – objekt

  • Článek

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

Viz také