SplashScreen (Java Platform SE 6) - xrath.com 에서 번역됨

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드

## 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

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.