My.Forms (Objeto) (Visual Basic)
Suministra las propiedades para tener acceso a una instancia de cada formulario Windows Forms declarada en el proyecto actual.
Comentarios
El objeto My.Forms proporciona una instancia de cada formulario en el proyecto actual. El nombre de la propiedad es igual que el nombre del formulario al que la propiedad tiene acceso. Para obtener información sobre cómo agregar formularios a un proyecto, vea Cómo: Agregar formularios Windows Forms a un proyecto.
Puede tener acceso a los formularios proporcionados por el objeto My.Forms utilizando el nombre del formulario, sin la calificación. Como el nombre de la propiedad es igual que el del tipo de formulario, se puede tener acceso a un formulario tal como si tuviera una instancia predeterminada. Por ejemplo, My.Forms.Form1.Show es equivalente a Form1.Show.
El objeto My.Forms expone sólo los formularios asociados al proyecto actual. No proporciona acceso a formularios declarados en archivos DLL a los que se hace referencia. Para tener acceso a un formulario que un archivo DLL proporciona, debe utilizar el nombre completo del formulario, escrito como nombreDeDll.nombreDeFormulario.
Puede utilizar la propiedad OpenForms para obtener una colección de los formularios abiertos de toda la aplicación.
El objeto y sus propiedades sólo están disponibles para las aplicaciones para Windows.
Propiedades
Cada propiedad del objeto My.Forms proporciona acceso a una instancia de un formulario en el proyecto actual. El nombre de la propiedad es el mismo que el del formulario al que la propiedad tiene acceso y el tipo de propiedad es igual que el tipo de formulario.
Nota
Si hay un conflicto de nombres, el nombre de la propiedad para tener acceso a un formulario es espacioDeNombresRaíz_espacioDeNombres_nombreDeFormulario. Por ejemplo, considere dos formularios denominados Form1. Si uno de ellos está en el espacio de nombres raíz WindowsApplication1 y en el espacio de nombres Namespace1, se tendría acceso a ese formulario a través de My.Forms.WindowsApplication1_Namespace1_Form1.
El objeto My.Forms proporciona acceso a la instancia del formulario principal de la aplicación que se creó en el inicio. Para todos los demás formularios, el objeto My.Forms crea una nueva instancia del formulario cuando se tiene acceso al mismo y la almacena. Los intentos siguientes de acceso a la propiedad devuelven esa instancia del formulario.
Puede desechar un formulario asignando Nothing a la propiedad para ese formulario. El establecedor de la propiedad llama al método Close del formulario y, a continuación, asigna Nothing al valor almacenado. Si se asigna un valor distinto de Nothing a la propiedad, el establecedor produce una excepción ArgumentException.
Puede probar si una propiedad del objeto My.Forms almacena una instancia del formulario mediante el operador Is o IsNot. Puede utilizar esos operadores para comprobar si el valor de la propiedad es Nothing.
Nota
Normalmente, el operador Is o IsNot tiene que leer el valor de la propiedad para realizar la comparación. Sin embargo, si la propiedad almacena actualmente Nothing, crea una nueva instancia del formulario y, a continuación, devuelve esa instancia. No obstante, el compilador de Visual Basic trata las propiedades del objeto My.Forms de forma diferente y permite al operador Is o IsNot comprobar el estado de la propiedad sin cambiar su valor.
Tareas
En la tabla siguiente se muestran ejemplos de tareas en la que está implicado el objeto My.Forms.
Para |
Vea |
Controlar un formulario desde otro formulario. |
Cómo: Establecer comunicación entre formularios en una aplicación (Visual Basic) |
Ejemplo
Este ejemplo cambia el título del formulario SidebarMenu predeterminado.
Sub ShowSidebarMenu(ByVal newTitle As String)
If My.Forms.SidebarMenu IsNot Nothing Then
My.Forms.SidebarMenu.Text = newTitle
End If
End Sub
Para que este ejemplo funcione, el proyecto debe tener un formulario denominado SidebarMenu. Para obtener más información, vea Cómo: Agregar formularios Windows Forms a un proyecto.
Este código sólo funcionará en un proyecto de aplicación para Windows.
Requisitos
Disponibilidad por tipo de proyecto
Tipo de proyecto |
Disponible |
Aplicación Windows |
Sí |
Biblioteca de clases |
No |
Aplicación de consola |
No |
Biblioteca de controles de Windows |
No |
Biblioteca de controles Web |
No |
Servicio de Windows |
No |
Sitio Web |
No |
Vea también
Tareas
Cómo: Agregar formularios Windows Forms a un proyecto
Referencia
IsNot (Operador) (Visual Basic)