Obiekt My.Forms
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 Jak: Dodawanie Windows Forms 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 Jak: Dodawanie Windows Forms 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
Jak: Dodawanie Windows Forms do projektu