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 手動關閉視窗，參見以下內容）。

顯示本機閃現螢幕有兩種方式：

• 如果是用命令行或快捷方式運行應用程序，則使用 "-splash:"Java 應用程序啟動器選項來顯示閃現螢幕。
  例如：

  java -splash:filename.gif Test
   

• 如果應用程序被打包在 jar 檔案中，可以使用清單檔案中的 "SplashScreen-Image" 選項來顯示閃現螢幕。將圖像放在 jar 歸檔檔案中並用選項指定路徑。路徑不應以斜槓開頭。
  例如，在 manifest.mf 檔案中：

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

  命令行介面的優先級高於清單設置。

SplashScreen 類別提供用於控制閃現螢幕的 API。此類別可用於關閉閃現螢幕、更改閃現螢幕圖像、獲取圖像位置/大小以及在閃現螢幕中進行繪製。它不能用於創建閃現螢幕；應當使用命令行或清單檔案選項來實作該操作。

此類別無法被實例化。只能存在一個此類別的實例，可以使用 getSplashScreen() 靜態方法獲得該實例。如果閃現螢幕不是通過命令行或清單檔案選項在應用程序啟動時創建的，那麼 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 形式），它允許在閃現螢幕上進行繪製。注意，不是在主圖像上繪製，而是在使用 alpha 混合的主圖像上顯示的圖像中進行繪製。 還要注意的是，在疊加圖像上繪製不必更新閃現螢幕視窗的內容。當希望閃現螢幕立即獲得更新時，應當在 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