java.awt
クラス SplashScreen

java.lang.Object
  java.awt.SplashScreen

public final class SplashScreen
extends Object

スプラッシュ画面は、アプリケーションの起動時に、Java 仮想マシン (JVM) の開始前に作成できます。スプラッシュ画面は、装飾のない、イメージを含むウィンドウとして表示されます。イメージには GIF、JPEG、および PNG ファイルを使用できます。アニメーション (GIF の場合) および透明度 (GIF、PNG の場合) がサポートされています。スプラッシュウィンドウは画面の中央に配置されます。複数モニターシステム上の位置は指定されません。その場合、プラットフォームと実装に依存します。Swing/AWT によって最初のウィンドウが表示されると、スプラッシュウィンドウは自動的に閉じます。また、Java API を使用して手動で閉じることもできます (下記を参照)。

ネイティブのスプラッシュ画面を表示する方法は 2 つあります。

• アプリケーションをコマンド行またはショートカットから実行する場合は、スプラッシュ画面を表示する Java アプリケーション起動オプションである「-splash:」を使用します。
  次に例を示します。

   java -splash:filename.gif Test
   

• アプリケーションが jar ファイルにパッケージ化されている場合は、マニフェストファイルで SplashScreen-Image オプションを使用してスプラッシュ画面を表示できます。イメージを jar アーカイブに配置し、このオプションでパスを指定します。パスには先頭のスラッシュを含めないでください。
  たとえば manifest.mf ファイルで次のように指定します。

   Manifest-Version: 1.0
   Main-Class: Test
   SplashScreen-Image: filename.gif
   

  コマンド行インタフェースは、マニフェスト設定よりも優先します。

SplashScreen クラスは、スプラッシュ画面を制御する API を提供します。このクラスは、スプラッシュ画面を閉じたり、スプラッシュ画面のイメージを変更したり、イメージの位置やサイズを取得したり、スプラッシュ画面内で描画したりするために使用できます。スプラッシュ画面を生成するためには使用できません。生成するには、コマンド行またはマニフェストファイルのオプションを使用してください。

このクラスはインスタンス化できません。このクラスのインスタンスは 1 つだけ存在でき、getSplashScreen() static メソッドを使用してインスタンスを取得できます。アプリケーションの起動時にコマンド行またはマニフェストファイルのオプションを使用してスプラッシュ画面が生成されなかった場合、getSplashScreen メソッドは null を返します。

導入されたバージョン:

1.6

メソッドの概要

void	close() スプラッシュ画面を隠し、ウィンドウを閉じ、関連するすべてのリソースを解放します。
Graphics2D	createGraphics() スプラッシュ画面に重ねて描画できる、スプラッシュ画面のオーバーレイイメージのグラフィックスコンテキストを Graphics2D オブジェクトとして生成します。
Rectangle	getBounds() スプラッシュ画面ウィンドウの境界を Rectangle として返します。
URL	getImageURL() 現在のスプラッシュ画面のイメージを返します。
Dimension	getSize() スプラッシュ画面ウィンドウのサイズを Dimension として返します。
static SplashScreen	getSplashScreen() Java 起動スプラッシュ画面制御に使用される SplashScreen オブジェクトを返します。
boolean	isVisible() スプラッシュ画面が可視かどうかを判定します。
void	setImageURL(URL imageURL) スプラッシュ画面のイメージを変更します。
void	update() オーバーレイイメージの現在の内容でスプラッシュウィンドウを更新します。

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

メソッドの詳細

getSplashScreen

public static SplashScreen getSplashScreen()

Java 起動スプラッシュ画面制御に使用される SplashScreen オブジェクトを返します。

戻り値:

SplashScreen インスタンス、または存在しないかすでに閉じられている場合は null

例外:

UnsupportedOperationException - スプラッシュ画面機能が現在のツールキットでサポートされない場合

HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合

setImageURL

public void setImageURL(URL imageURL)
                 throws NullPointerException,
                        IOException,
                        IllegalStateException

スプラッシュ画面のイメージを変更します。新しいイメージは指定された URL からロードされます。サポートされるイメージ形式は GIF、JPEG、および PNG です。このメソッドは、イメージのロードが終了してウィンドウが更新されると戻ります。スプラッシュ画面は、イメージのサイズに合わせてサイズが変更され、画面の中央に配置されます。

パラメータ:

imageURL - 新しいスプラッシュ画面イメージの、null でない URL

例外:

NullPointerException - imageURL が null の場合

IOException - イメージのロード時にエラーが発生した場合

IllegalStateException - スプラッシュ画面がすでに閉じられている場合

getImageURL

public URL getImageURL()
                throws IllegalStateException

現在のスプラッシュ画面のイメージを返します。

戻り値:

現在のスプラッシュ画面のイメージファイルの URL

例外:

IllegalStateException - スプラッシュ画面がすでに閉じられている場合

getBounds

public Rectangle getBounds()
                    throws IllegalStateException

スプラッシュ画面ウィンドウの境界を Rectangle として返します。たとえばスプラッシュ画面を同じ位置で、そのあとに表示するウィンドウに置き換える場合に便利です。

スプラッシュ画面のサイズや位置は制御できません。スプラッシュ画面のサイズは、イメージが変更されると自動的に調整されます。

戻り値:

スプラッシュ画面の境界が格納された Rectangle

例外:

IllegalStateException - スプラッシュ画面がすでに閉じられている場合

getSize

public Dimension getSize()
                  throws IllegalStateException

スプラッシュ画面ウィンドウのサイズを Dimension として返します。たとえばスプラッシュ画面のオーバーレイ表面に描画する場合に便利です。

スプラッシュ画面のサイズや位置は制御できません。スプラッシュ画面のサイズは、イメージが変更されると自動的に調整されます。

戻り値:

スプラッシュ画面のサイズを示す Dimension オブジェクト

例外:

IllegalStateException - スプラッシュ画面がすでに閉じられている場合

createGraphics

public Graphics2D createGraphics()
                          throws IllegalStateException

スプラッシュ画面に重ねて描画できる、スプラッシュ画面のオーバーレイイメージのグラフィックスコンテキストを Graphics2D オブジェクトとして生成します。メインイメージには描画せず、アルファ合成を使用してメインイメージ上に表示されるイメージに描画します。また、オーバーレイイメージに描画する場合、スプラッシュ画面ウィンドウの内容を更新する必要はありません。スプラッシュ画面をすぐに更新する場合は、SplashScreen で update() を呼び出してください。

戻り値:

スプラッシュ画面のオーバーレイ表面のグラフィックスコンテキスト

例外:

IllegalStateException - スプラッシュ画面がすでに閉じられている場合

update

public void update()
            throws IllegalStateException

オーバーレイイメージの現在の内容でスプラッシュウィンドウを更新します。

例外:

IllegalStateException - オーバーレイイメージが存在しない場合。たとえば createGraphics が呼び出されなかった場合、またはスプラッシュ画面がすでに閉じられている場合

close

public void close()
           throws IllegalStateException

スプラッシュ画面を隠し、ウィンドウを閉じ、関連するすべてのリソースを解放します。

例外:

IllegalStateException - スプラッシュ画面がすでに閉じられている場合

isVisible

public boolean isVisible()

スプラッシュ画面が可視かどうかを判定します。スプラッシュ画面は close() を使用して非表示にできます。また、最初の AWT/Swing ウィンドウが可視になると、自動的に非表示になります。

戻り値:

スプラッシュ画面が可視である (まだ閉じていない) 場合は true、そうでない場合は false