My.Forms – objekt

  • Článek
  • 2 min ke čtení

Poskytuje vlastnosti pro přístup k instanci každého Windows formuláře 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é vlastnost přistupuje.

K formulářům poskytovaným objektem můžete přistupovat pomocí My.Forms 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 zpřístupň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. Pro přístup k formuláři, který knihovna DLL poskytuje, je nutné použít kvalifikovaný název formuláře napsané jako DllName. FormName.

Pomocí vlastnosti můžete získat kolekci všech otevřených formulářů OpenForms aplikace.

Objekt a jeho vlastnosti jsou k dispozici pouze pro Windows aplikace.

Vlastnosti

Každá vlastnost My.Forms objektu poskytuje přístup k instanci formuláře v aktuálním projektu. Název vlastnosti je stejný jako název formuláře, ke které vlastnost přistupuje, a typ vlastnosti je stejný jako typ formuláře.

Poznámka

Pokud dojde ke kolizím názvů, název vlastnosti pro přístup k formuláři je RootNamespace _ Namespace _ FormName. Představte si například dva formuláře s názvem Pokud je jeden z těchto formulářů v kořenovém oboru názvů a v oboru názvů , budete k této formuláři přistupovat Form1. WindowsApplication1 prostřednictvím Namespace1 My.Forms.WindowsApplication1_Namespace1_Form1 .

Objekt poskytuje přístup k instanci hlavního formuláře aplikace, který My.Forms byl vytvořen při spuštění. Pro všechny ostatní formuláře objekt vytvoří novou instanci formuláře při přístupu a uloží My.Forms ji. Následné pokusy o přístup k této vlastnosti vrátí tuto instanci formuláře.

Formulář můžete zbavit přiřazením k Nothing vlastnosti pro tento formulář. Metoda setter vlastnosti volá metodu formuláře a pak ji přiřadí Close Nothing uložené hodnotě. Pokud přiřadíte jinou hodnotu než vlastnosti Nothing , metoda setter vyvolá ArgumentException výjimku.

Pomocí operátoru nebo můžete otestovat, jestli vlastnost objektu uchovává instanci My.Forms Is IsNot formuláře. Tyto operátory můžete použít ke kontrole, jestli je hodnota vlastnosti Nothing .

Poznámka

Operátor or Is IsNot obvykle musí přečíst hodnotu vlastnosti, aby bylo provedeno porovnání. Pokud ale vlastnost aktuálně ukládá , vytvoří vlastnost novou instanci formuláře Nothing a pak tuto instanci vrátí. Kompilátor Visual Basic zpracovává vlastnosti objektu odlišně a umožňuje operátoru nebo zkontrolovat stav vlastnosti beze My.Forms Is změny jeho IsNot 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 Windows aplikace.

Požadavky

Dostupnost podle typu projektu

Typ projektu K dispozici.
Aplikace pro systém Windows Ano
Knihovna tříd No
Konzolová aplikace No
Windows Knihovna ovládacích prvků No
Knihovna webových ovládacích prvků No
Služba systému Windows No
Webu No

Viz také