My.Application.SplashScreen (Propiedad)

Actualización: noviembre 2007

Obtiene o establece la pantalla de inicio de esta aplicación.

' Usage
Dim value As System.Windows.Forms.Form = My.Application.SplashScreen
' Declaration
Public Property SplashScreen As System.Windows.Forms.Form

Valor devuelto

Un objeto Form que utiliza la aplicación como pantalla de inicio.

Excepciones

La siguiente condición puede provocar una excepción:

  • Se ha asignado el mismo valor a esta propiedad y a la propiedad My.Application.MainForm (ArgumentNullException).

Comentarios

La propiedad My.Application.SplashScreen le permite obtener o establecer el objeto Form que utiliza la aplicación como pantalla de inicio, la primera forma gráfica que aparece mientras se inicia una aplicación.

Esta propiedad admite el modelo de aplicaciones de Visual Basic. Para obtener más información, vea Información general sobre el modelo de aplicaciones de Visual Basic.

Los cambios efectuados en esta propiedad no se conservan cuando se cierra la aplicación. Para cambiar permanentemente la pantalla de inicio, debe cambiar el ajuste en el Diseñador de proyectos. Para obtener más información, vea Cómo: Especificar una pantalla de presentación para una aplicación (Visual Basic).

Ejemplo

Este ejemplo utiliza la propiedad My.Application.SplashScreen y el evento My.Application.Startup para actualizar la pantalla de inicio con información de estado mientras se inicia la aplicación.

Private Sub MyApplication_Startup( _
    ByVal sender As Object, _
    ByVal e As Microsoft.VisualBasic.ApplicationServices.StartupEventArgs _
) Handles Me.Startup
    ' Get the splash screen.
    Dim splash As SplashScreen1 = CType(My.Application.SplashScreen, SplashScreen1)
    ' Display current status information.
    splash.Status = "Current user: " & My.User.Name
End Sub

Este ejemplo requiere que el proyecto tenga una pantalla de inicio denominada SplashScreen1. La pantalla de inicio debe tener una propiedad denominada Status que actualiza su interfaz de usuario.

Debe escribir este código en la ventana del Editor de código para los eventos de aplicaciones. Para obtener más información, vea Cómo: Controlar eventos de aplicaciones (Visual Basic).

Requisitos

Espacio de nombres:Microsoft.VisualBasic.ApplicationServices

Clase:WindowsFormsApplicationBase

Ensamblado: biblioteca en tiempo de ejecución de Visual Basic (en Microsoft.VisualBasic.dll)

Disponibilidad por tipo de proyecto

Tipo de proyecto

Disponible

Aplicación para Windows

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

Permisos

No se requiere ningún permiso.

Vea también

Referencia

My.Application (Objeto)

My.Application.MinimumSplashScreenDisplayTime (Propiedad)

System.Windows.Forms.Form

WindowsFormsApplicationBase.SplashScreen