Класс SplashScreen

public final class SplashScreen
extends Object

Экран загрузки может быть показан при запуске приложения, перед запуском виртуальной машины Java (JVM). Экран загрузки отображается как окно без оформления, содержащее изображение. Для изображения можно использовать файлы GIF, JPEG или PNG. Анимация поддерживается для формата GIF, а прозрачность — для GIF и PNG. Окно размещается в центре экрана. Позиция на системах с несколькими мониторами не задана. Она зависит от платформы и реализации.

Экран загрузки закрывается автоматически, как только первое окно отображается Swing/AWT (также может быть закрыт вручную с помощью API Java, см. ниже).

Если ваше приложение упаковано в файл jar, вы можете использовать опцию "SplashScreen-Image" в файле манифеста, чтобы отобразить экран загрузки. Поместите изображение в архив jar и укажите путь в опции. Путь не должен начинаться с косой черты.
Например, в файле manifest.mf:

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

Если реализация Java предоставляет командную строку и вы запускаете приложение с помощью командной строки или ярлыка, используйте опцию запуска приложения Java, чтобы показать экран загрузки. Реализация Oracle позволяет указать расположение изображения экрана загрузки с помощью опции -splash:.
Например:

java -splash:filename.gif Test

Командная строка имеет больший приоритет по сравнению с настройками манифеста.

Экран загрузки будет отображен максимально точно, чтобы представить все изображение экрана загрузки, учитывая ограничения целевой платформы и дисплея.

Подразумевается, что указанное изображение отображается на экране "как есть", то есть сохраняются точные значения цветов, как указано в файле изображения. Однако в определенных обстоятельствах отображаемое изображение может отличаться, например, при применении цветового дithering для отображения изображения с 32 битами на пиксель (bpp) на экране с 16 или 8 bpp. Настройка дисплея родной платформы также может повлиять на цвета отображаемого изображения (например, цветовые профили и т. д.)

Класс SplashScreen предоставляет API для управления экраном загрузки. Этот класс можно использовать для закрытия экрана загрузки, изменения изображения экрана загрузки, получения положения/размера окна родного экрана загрузки и рисования на экране загрузки. Он не может использоваться для создания экрана загрузки. Для этого необходимо использовать опции, предоставляемые реализацией Java.

Этот класс не может быть инстанцирован. Может существовать только один экземпляр этого класса, который можно получить, используя статический метод getSplashScreen(). В случае, если экран загрузки не был создан при запуске приложения через командную строку или опцию файла манифеста, метод getSplashScreen возвращает null.

Методы

getSplashScreen

public static SplashScreen getSplashScreen()

Возвращает объект SplashScreen, используемый для управления экраном загрузки Java при запуске на системах, поддерживающих отображение.

Возвращает:

экземпляр SplashScreen, или null если его нет или он уже был закрыт

Исключение:

UnsupportedOperationException - если функция экрана загрузки не поддерживается текущей библиотекой

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true

setImageURL

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

Изменяет изображение экрана загрузки. Новое изображение загружается из указанного URL; поддерживаются форматы изображений GIF, JPEG и PNG. Метод возвращает после завершения загрузки изображения и обновления окна. Окно экрана загрузки изменяет размер в соответствии с размером изображения и центрируется на экране.

Параметры:

imageURL - URL для нового изображения экрана загрузки

Исключение:

NullPointerException - если imageURL равно null

IOException - если произошла ошибка при загрузке изображения

IllegalStateException - если экран загрузки уже закрыт

getImageURL

public URL getImageURL()
                throws IllegalStateException

Возвращает текущее изображение экрана загрузки.

Возвращает:

URL текущего файла изображения экрана загрузки

Исключение:

IllegalStateException - если экран загрузки уже закрыт

getBounds

public Rectangle getBounds()
                    throws IllegalStateException

Возвращает:

объект Rectangle, содержащий границы экрана загрузки

Исключение:

IllegalStateException - если экран загрузки уже закрыт

getSize

public Dimension getSize()
                  throws IllegalStateException

Возвращает:

объект Dimension, указывающий размер экрана загрузки

Исключение:

IllegalStateException - если экран загрузки уже закрыт

createGraphics

public Graphics2D createGraphics()
                          throws IllegalStateException

Возвращает:

контекст графики для наложенного слоя экрана загрузки

Исключение:

IllegalStateException - если экран загрузки уже закрыт

update

public void update()
            throws IllegalStateException

Обновляет окно экрана загрузки текущим содержимым наложенного изображения.

Исключение:

IllegalStateException - если наложенное изображение не существует; например, если createGraphics никогда не вызывался, или если экран загрузки уже закрыт

close

public void close()
           throws IllegalStateException

Скрывает экран загрузки, закрывает окно и высвобождает все связанные ресурсы.

Исключение:

IllegalStateException - если экран загрузки уже закрыт

isVisible

public boolean isVisible()

Возвращает:

true, если экран загрузки отображается (ещё не закрыт), false в противном случае