Udostępnij za pośrednictwem


My.Forms — Obiekt

Zapewnia właściwości do uzyskiwania dostępu do wystąpienia każdego formularza Windows zadeklarowana w bieżącym projekcie.

Uwagi

My.Forms Obiektu zapewnia wystąpienie każdego formularza w bieżącym projekcie.Nazwa właściwości jest taka sama jak nazwa formularza, który uzyskuje dostęp do właściwości.Informacje dotyczące dodawania formularzy do projektu, zobacz Porady: dodawanie formularzy systemu Windows do projektu.

Można uzyskać dostęp do formularzy, świadczone przez My.Forms obiektu przy użyciu nazwy formularza, bez kwalifikacji.Ponieważ nazwa właściwości jest taka sama jak nazwa typ formularza, pozwala przejść do formularza tak, jakby był domyślnym wystąpieniem.Na przykład My.Forms.Form1.Show jest równoważne z Form1.Show.

My.Forms Obiekt udostępnia tylko formularze skojarzone z bieżącym projektem.Nie zapewnia jednak dostęp do formularzy zadeklarowane w dll, do której następuje odwołanie.Aby dostęp do formularza, który zawiera bibliotekę DLL, należy użyć kwalifikowaną nazwę formularza, zapisywane jako Nazwa_pliku_dll. FormName.

Można użyć OpenForms właściwość, aby pobrać kolekcji aplikacji wszystkich otwartych formularzy.

Obiekt i jego właściwości są dostępne tylko dla aplikacji systemu Windows.

Właściwości

Każda właściwość My.Forms obiektu zapewnia dostęp do wystąpienia formularza w bieżącym projekcie.Nazwa właściwości jest taka sama, jak nazwa formularza, który uzyskuje dostęp do właściwości i typ właściwości jest taki sam, jak typ formularza.

[!UWAGA]

W przypadku kolizji nazw, nazwę właściwości, aby przejść do formularza jest RootNamespace_obszaru nazw_FormName.Na przykład, rozważmy dwie formy o nazwie Form1.jednej z tych form, jeśli jest w obszarze nazw root WindowsApplication1 i w obszarze nazw Namespace1, byłoby dostępu tego formularza za pomocą My.Forms.WindowsApplication1_Namespace1_Form1.

My.Forms Obiektu zapewnia dostęp do wystąpienia aplikacji formularz główny, który został utworzony podczas uruchamiania.Dla innych form My.Forms obiektu tworzy nowe wystąpienie formularza, gdy jest dostępny i zapisuje go.Kolejne próby dostępu do tej właściwości zwracają wystąpienie tego formularza.

Można zbyć formularza, przypisując Nothing do właściwości tego formularza.Wywołania metody ustawiającej właściwość Close metodę formularza, a następnie przypisuje Nothing do zapisanych wartości.Po przypisaniu wartości inne niż Nothing do właściwości, metody ustawiającej wyrzuca ArgumentException wyjątku.

Można sprawdzić, czy właściwość My.Forms obiekt zapisuje wystąpienie formularza za pomocą Is lub IsNot operatora.Można użyć tych podmiotów gospodarczych, aby sprawdzić, czy wartość właściwości jest Nothing.

[!UWAGA]

Zazwyczaj Is lub IsNot operator musi odczytać wartość właściwości przeprowadzenie porównania.Jednakże jeśli właściwość przecho wuje obecnie Nothing, właściwość tworzy nowe wystąpienie formularza, a następnie zwraca instancję.Jednak kompilator Visual Basic traktuje właściwości My.Forms inaczej obiekt i pozwala na Is lub IsNot operatora, aby sprawdzić stan właściwości bez zmieniania jej wartość.

Przykład

Nazwa domyślna zmienia się w tym przykładzie SidebarMenu formularza.

Sub ShowSidebarMenu(ByVal newTitle As String)
    If My.Forms.SidebarMenu IsNot Nothing Then
        My.Forms.SidebarMenu.Text = newTitle
    End If 
End Sub

W tym przykładzie do pracy projektu muszą mieć formularz o nazwie SidebarMenu.Aby uzyskać więcej informacji, zobacz Porady: dodawanie formularzy systemu Windows do projektu.

Ten kod będzie działać tylko w projekt aplikacji systemu Windows.

Wymagania

Dostępność wg typu projektu

Typ projektu

Dostępne

Aplikacja systemu Windows

Tak

Biblioteka klas

Nr

Aplikacja konsoli

Nr

Biblioteka formantów systemu Windows

Nr

Biblioteka formantów sieci Web

Nr

Usługa systemu Windows

Nr

Witryna sieci Web

Nr

Zobacz też

Zadania

Porady: dodawanie formularzy systemu Windows do projektu

Informacje

OpenForms

Is — Operator (Visual Basic)

IsNot — Operator (Visual Basic)

Form

Close

Koncepcje

Obiekty (Visual Basic)

Uzyskiwanie dostępu do formularzy aplikacji (Visual Basic)