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 파일에 패키지화되고 있는 경우는, Manifest 파일로 SplashScreen-Image 옵션을 사용해 스플래쉬 화면을 표시할 수 있습니다. 이미지를 jar 어카이브(archive)에 배치해, 이 옵션으로 패스를 지정합니다. 패스에는 선두의 slash를 포함하지 말아 주세요.
  예를 들어 manifest.mf 파일로 다음과 같이 지정합니다.

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

  커멘드행 인터페이스는, Manifest 설정보다 우선합니다.

SplashScreen 클래스는, 스플래쉬 화면을 제어하는 API 를 제공합니다. 이 클래스는, 스플래쉬 화면을 닫거나 스플래쉬 화면의 이미지를 변경하거나 이미지의 위치나 사이즈를 취득하거나 스플래쉬 화면내에서 draw 하거나 하기 위해서 사용할 수 있습니다. 스플래쉬 화면을 생성하기 위해서는 사용할 수 없습니다. 생성하려면 , 커멘드행 또는 Manifest 파일의 옵션을 사용해 주세요.

이 클래스는 인스턴스화할 수 없습니다. 이 클래스의 인스턴스는 1 개만 존재할 수 있어getSplashScreen() static 메소드를 사용해 인스턴스를 취득할 수 있습니다. 어플리케이션의 기동시에 커멘드행 또는 Manifest 파일의 옵션을 사용해 스플래쉬 화면이 생성되지 않았던 경우,getSplashScreen 메소드는 null 를 돌려줍니다.

도입된 버젼:

1.6

메소드의 개요

void	close () 스플래쉬 화면을 숨겨, 윈도우를 닫아 관련하는 모든 자원을 해제합니다.
Graphics2D	createGraphics () 스플래쉬 화면에 거듭해 draw 할 수 있는, 스플래쉬 화면의 오버레이 이미지의 그래픽스 문맥을 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 로서 돌려줍니다. 예를 들어 스플래쉬 화면의 오버레이 표면에 draw 하는 경우에 편리합니다.

스플래쉬 화면의 사이즈나 위치는 제어할 수 없습니다. 스플래쉬 화면의 사이즈는, 이미지가 변경되면(자) 자동적으로 조정됩니다.

반환값:

스플래쉬 화면의 사이즈를 나타내는 Dimension 객체

예외:

IllegalStateException - 스플래쉬 화면이 벌써 닫혀지고 있는 경우

createGraphics

public Graphics2D  createGraphics()
                          throws IllegalStateException 

스플래쉬 화면에 거듭해 draw 할 수 있는, 스플래쉬 화면의 오버레이 이미지의 그래픽스 문맥을 Graphics2D 객체로서 생성합니다. 메인 이미지에는 draw 하지 않고, 알파 합성을 사용해 메인 이미지상에 표시되는 이미지에 draw 합니다. 또, 오버레이 이미지에 draw 하는 경우, 스플래쉬 화면 윈도우의 내용을 갱신할 필요는 없습니다. 스플래쉬 화면을 곧바로 갱신하는 경우는,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