| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
SplashScreen splash = SplashScreen.getSplashScreen();
Based on 39 examples
public final class SplashScreen extends Object
The splash screen can be created at application startup, before the Java Virtual Machine (JVM) starts. The splash screen is displayed as an undecorated window containing an image. You can use GIF, JPEG, and PNG files for the image. Animation (for GIF) and transparency (for GIF, PNG) are supported. The window is positioned at the center of the screen (the position on multi-monitor systems is not specified - it is platform and implementation dependent). The window is closed automatically as soon as the first window is displayed by Swing/AWT (may be also closed manually using the Java API, see below).
There are two ways to show the native splash screen:
java -splash:filename.gif Test
manifest.mf
file:
Manifest-Version: 1.0 Main-Class: Test SplashScreen-Image: filename.gifThe command line interface has higher precedence over the manifest setting.
The {@code SplashScreen} class provides the API for controlling the splash screen. This class may be used to close the splash screen, change the splash screen image, get the image position/size and paint in the splash screen. It cannot be used to create the splash screen; you should use the command line or manifest file option for that.
This class cannot be instantiated. Only a single instance of this class
can exist, and it may be obtained using the {@link #getSplashScreen()}
static method. In case the splash screen has not been created at
application startup via the command line or manifest file option,
the getSplashScreen
method returns null
.
Method Summary | |
---|---|
void |
close() Hides the splash screen, closes the window, and releases all associated resources. |
Graphics2D |
Creates a graphics context (as a java.awt.Graphics2D object) for the splash screen overlay image, which allows you to draw over the splash screen. |
Rectangle |
Returns the bounds of the splash screen window as a java.awt.Rectangle. |
URL |
Returns the current splash screen image. |
Dimension |
getSize() Returns the size of the splash screen window as a java.awt.Dimension. |
static SplashScreen |
Returns the object used for Java startup splash screen control. |
boolean |
Determines whether the splash screen is visible. |
void |
setImageURL(URL imageURL) Changes the splash screen image. |
void |
update() Updates the splash window with current contents of the overlay image. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Method Detail |
---|
public synchronized void close() throws IllegalStateException
IllegalStateException
- if the splash screen has already been closedpublic Graphics2D createGraphics() throws IllegalStateException
SplashScreen
when you want the splash screen to be
updated immediately.
IllegalStateException
- if the splash screen has already been closedpublic Rectangle getBounds() throws IllegalStateException
You cannot control the size or position of the splash screen. The splash screen size is adjusted automatically when the image changes.
IllegalStateException
- if the splash screen has already been closedpublic synchronized URL getImageURL() throws IllegalStateException
IllegalStateException
- if the splash screen has already been closedpublic Dimension getSize() throws IllegalStateException
You cannot control the size or position of the splash screen. The splash screen size is adjusted automatically when the image changes.
IllegalStateException
- if the splash screen has already been closedpublic static synchronized SplashScreen getSplashScreen()
null
if there is
none or it has already been closedpublic boolean isVisible()
public void setImageURL(URL imageURL) throws NullPointerException, IOException, IllegalStateException
imageURL
- the non-null
URL for the new
splash screen imageNullPointerException
- if {@code imageURL} is null
IOException
- if there was an error while loading the imageIllegalStateException
- if the splash screen has already been
closedpublic void update() throws IllegalStateException
IllegalStateException
- if the overlay image does not exist;
for example, if {@code createGraphics} has never been called,
or if the splash screen has already been closed
| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |