My.Application.SplashScreen プロパティ

[アーティクル]
08/16/2008

更新 : 2007 年 11 月

このアプリケーションのスプラッシュスクリーンを取得または設定します。

' 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 コントロールライブラリ	不可
Web コントロールライブラリ	不可
Windows サービス	不可
Web サイト	不可