java.awt

Class 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，见下文）。

如果你的应用程序是封装在一个jar文件，你可以使用一个manifest文件”弹出窗口的图像”选项来显示初始屏幕。将图像放在“罐子存档”中，并在选项中指定路径。路径不应该有一个领先的削减。
为例，在manifest.mf文件：

清单版本：1主要类别：测试弹出窗口形象：filename.gif

如果java的实现提供了命令行界面，你运行你的应用程序通过使用命令行或快捷方式，使用java应用程序启动器选项显示初始屏幕。Oracle的参考实现，让你与-splash:选项指定初始屏幕图像的位置。
例如：

java飞溅：filename.gif试验

命令行界面在显示设置的优先级更高。

飞溅屏幕将显示尽可能忠实地呈现整个屏幕图像的限制，目标平台和显示。

它是暗示，指定的图像在屏幕上呈现的“为”，即保存在图像文件中指定的精确的颜色值。在某些情况下，虽然，所提出的图像可能会有所不同，例如在应用颜色抖动呈现32位每像素（BPP）在16或8位的屏幕图像。本机的平台显示配置也可能会影响所显示的图像的颜色（如颜色配置文件等）。

SplashScreen类提供的API来控制屏幕。这个类可以用来关闭启动屏幕，改变飞溅的屏幕图像，得到的初始屏幕上的本地窗口位置/大小，以及在启动屏幕上的油漆。它不能用于创建启动屏幕。你应该用java实现提供的选项。

这类不能被实例化。只有一个实例可以存在，它可以通过使用静态方法得到getSplashScreen()。如果屏幕没有在应用程序启动时通过命令行选项创建的文件或清单，getSplashScreen方法返回null。

从以下版本开始：

一点六

方法摘要

Modifier and Type	Method and Description
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() 更新与覆盖图像的当前内容的窗口窗口。

Methods inherited from class 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 -新的屏幕图像的non- null URL

异常

如果是 null imageURL NullPointerException

IOException -如果有一个错误在加载图像

IllegalStateException如果飞溅屏幕已经关闭

getImageURL

public URL getImageURL()
                throws IllegalStateException

返回当前的启动屏幕图像。

结果

当前启动屏幕图像文件的网址

异常

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对象）为初始屏幕覆盖图像，你可以画在屏幕。请注意，您不使用主图像，但在主图像上显示的图像，使用阿尔法混合。还请注意，在覆盖图像上绘制不一定更新“启动屏幕”窗口的内容。你应该打电话给 update()在 SplashScreen当你想要的屏幕会立即更新。

像素（0，0）在图形上下文坐标空间对应的闪屏机窗口边界的起源（见getBounds()）。

结果

用于启动屏幕覆盖表面的图形上下文

异常

IllegalStateException如果飞溅屏幕已经关闭

update

public void update()
            throws IllegalStateException

更新与覆盖图像的当前内容的窗口窗口。

异常

IllegalStateException如果覆盖图像不存在；例如，如果 createGraphics从来没有叫，或者如果屏幕已经关闭

close

public void close()
           throws IllegalStateException

隐藏启动屏幕，关闭窗口，并释放所有相关的资源。

异常

IllegalStateException如果飞溅屏幕已经关闭

isVisible

public boolean isVisible()

确定是否可见启动屏幕。初始屏幕可以隐藏使用 close()，也是自动隐藏，当第一AWT/Swing窗口是可见的。

请注意，本机平台可能会延迟呈现在屏幕上的“启动”屏幕上的“本地”窗口。true的返回值为该方法只能保证隐藏启动画面窗口的情况还没发生。

结果

如果启动屏幕是可见的（并没有被关闭），否则为假