java.awt

Класс SplashScreen

java.lang. Объект

java.awt. SplashScreen

public final class SplashScreen
extends Object

Экран-заставка может быть выведен на экран при запуске приложения, прежде, чем виртуальная машина Java (JVM) запустится. Экран-заставка выводится на экран как неукрашенное окно, содержащее изображение. Можно использовать ДЖИФА, JPEG, или файлы PNG для изображения. Анимация поддерживается для формата ДЖИФА, в то время как прозрачность поддерживается и для ДЖИФА и для PNG. Окно располагается в центр экрана. Позиция на мультисистемах контроля не определяется. Это - платформа и зависящий от реализации. Окно экрана-заставки закрывается автоматически, как только первое окно выводится на экран Swing/AWT (может быть также закрыт, вручную используя API Java, видеть ниже).

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

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

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

 java -splash:filename.gif Test
 

У интерфейса командной строки есть более высокий приоритет по явной установке.

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

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

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

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

С тех пор:

1.6

Сводка метода

Модификатор и Тип	Метод и Описание
void	close() Скрывает экран-заставку, закрывает окно, и высвобождает все связанные средства.
Graphics2D	createGraphics() Создает графический контекст (как a Graphics2D объект), поскольку экран-заставка накладывают изображение, которое позволяет Вам дистиллировать экран-заставку.
Прямоугольник	getBounds() Возвращает границы окна экрана-заставки как a Rectangle.
URL	getImageURL() Возвращает текущее изображение экрана-заставки.
Размерность	getSize() Возвращает размер окна экрана-заставки как a Dimension.
static SplashScreen	getSplashScreen() Возвраты SplashScreen объект, используемый для Java, запускает управление экраном-заставкой на системах тот дисплей поддержки.
boolean	isVisible() Определяет, видим ли экран-заставка.
void	setImageURL(URL imageURL) Изменяет изображение экрана-заставки.
void	update() Обновляет окно всплеска с текущим содержанием оверлейного изображения.

Методы, наследованные от class java.lang. Объект

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

Деталь метода

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; ДЖИФ, JPEG и форматы изображения PNG поддерживаются. Возвраты метода после изображения закончили загружаться, и окно было обновлено. Окно экрана-заставки изменяется согласно размеру изображения и центрируется на экране.

Параметры:

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

Броски:

NullPointerException - если imageURL null

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

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

getImageURL

public URL getImageURL()
                throws IllegalStateException

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

Возвраты:

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

Броски:

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

getBounds

public Rectangle getBounds()
                    throws IllegalStateException

Возвращает границы окна экрана-заставки как a Rectangle. Это может быть полезно, если, например, Вы хотите заменить экран-заставку своим окном в том же самом расположении.

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

Изображение может содержать прозрачные области, и таким образом границы, о которых сообщают, могут быть больше чем видимое изображение экрана-заставки на экране.

Возвраты:

a Rectangle содержа границы экрана-заставки

Броски:

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

getSize

public Dimension getSize()
                  throws IllegalStateException

Возвращает размер окна экрана-заставки как a Dimension. Это может быть полезно, если, например, Вы хотите привлечь оверлейную поверхность экрана-заставки.

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

Изображение может содержать прозрачные области, и таким образом размер, о котором сообщают, может быть больше чем видимое изображение экрана-заставки на экране.

Возвраты:

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

Броски:

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

createGraphics

public Graphics2D createGraphics()
                          throws IllegalStateException

Создает графический контекст (как a Graphics2D объект), поскольку экран-заставка накладывают изображение, которое позволяет Вам дистиллировать экран-заставку. Отметьте, что Вы не привлекаете основное изображение, но на изображении, которое выводится на экран по основному изображению, используя альфа-смешивание. Также отметьте, что привлечение оверлейного изображения не обязательно обновляет содержание окна экрана-заставки. Следует вызвать update() на SplashScreen когда Вы хотите, чтобы экран-заставка был сразу обновлен.

Пиксель (0, 0) в координатном пространстве графического контекста соответствует источнику экрана-заставки собственные границы окна (см. getBounds()).

Возвраты:

графический контекст для экрана-заставки накладывает поверхность

Броски:

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

обновление

public void update()
            throws IllegalStateException

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

Броски:

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

близко

public void close()
           throws IllegalStateException

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

Броски:

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

isVisible

public boolean isVisible()

Определяет, видим ли экран-заставка. Экран-заставка может быть скрыт, используя close(), это также скрывается автоматически, когда первое окно AWT/Swing делается видимым.

Отметьте, что собственная платформа может задержать представление экрана-заставки собственное окно на экране. Возвращаемое значение true поскольку этот метод только гарантирует, что условия скрыть окно экрана-заставки еще не произошли.

Возвраты:

истина, если экран-заставка видим (еще не был закрыт), ложь иначе