Поделиться через


Свойство My.Application.SplashScreen

Обновлен: Ноябрь 2007

Получает или задает экран-заставку для этого приложения.

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

Возвращаемое значение

Объект Form, который приложение использует в качестве экрана-заставки.

Исключения

Следующее условие может вызвать исключение.

  • Одно и то же значение присвоено этому свойству и свойству My.Application.MainForm (ArgumentNullException).

Заметки

Свойство My.Application.SplashScreen позволяет получить или установить объект Form, который приложение использует в качестве заставки — первой графической формы, которая отображается при запуске приложения.

Это свойство поддерживает модель приложения Visual Basic. Дополнительные сведения см. в разделе Обзор модели приложения в Visual Basic.

Изменение значения этого свойства не сохраняется при закрытии приложения. Чтобы изменить заставку навсегда, необходимо изменить значение параметра в Конструкторе проектов. Дополнительные сведения см. в разделе Практическое руководство. Назначение экрана-заставки для приложения (Visual Basic).

Пример

В этом примере используется свойство My.Application.SplashScreen и событие My.Application.Startup для обновления экрана-заставки данными о состоянии при запуске приложения.

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

Этот пример требует, чтобы проект имел заставку с именем SplashScreen1. Заставка должна иметь свойство с именем Status, которое обновляет его пользовательский интерфейс.

Необходимо ввести этот код в окне редактора кода для событий приложения. Дополнительные сведения см. в разделе Практическое руководство. Обработка событий приложения (Visual Basic).

Требования

Пространство имен:Microsoft.VisualBasic.ApplicationServices

Класс:WindowsFormsApplicationBase

Сборка: библиотека времени выполнения Visual Basic (в Microsoft.VisualBasic.dll)

Доступность по типу проекта

Тип проекта

Доступно

Приложение Windows

Да

Библиотека классов

Нет

Консольное приложение

Нет

Библиотека элементов управления Windows

Нет

Библиотека веб-элементов управления

Нет

Служба Windows

Нет

Веб-узел

Нет

Разрешения

Разрешения не требуются.

См. также

Ссылки

Объект My.Application

Свойство My.Application.MinimumSplashScreenDisplayTime

System.Windows.Forms.Form

WindowsFormsApplicationBase.SplashScreen