Visual Mobile Designer Custom Components: Using Splash Screens in Java ME Applications
Splash screens are used to enhance the look and feel of an application. Typically, you use a splash screen when the program starts,
or to display a logo or branding information. It gives users the first impression of your application. The Visual Mobile Designer (VMD)
in NetBeans includes the SplashScreen custom component in the VMD palette. This brief example shows you how to create a new Java ME project
using NetBeans that uses the SplashScreen component. It will also explain how to use the features to design and implement your own splash
screens using this feature.
If you are new to mobile application development in NetBeans, you should start with the NetBeans Java ME MIDP Quick Start Guide before continuing.
To complete this tutorial, you need the following software and resources:
Installing Visual Mobile Designer
The NetBeans Visual Mobile Designer (VMD) is a graphical interface that enables you to design mobile applications using drag and drop components. The VMD allows you to define the application flow and design your GUI using the components supplied by the IDE or components you design yourself. The VMD contains many standard User Interface (UI) components that you can use to create applications such as Lists, Alerts, Forms and Images. It also includes custom components that simplify the creation of more complex features, such as Wait Screens, Splash Screens, Table Items and more.
To install the Visual Mobile Designer plugin, complete the following steps:
- Choose Tools > Plugins from the main menu.
- On the Available Plugins tab of the Plugins dialog box, select Visual Mobile Designer and click Install.
- At the Welcome page of the Installer dialog box, click Next.
- At the License Agreement page, read the license agreements associated with the plugin. If you agree to the terms of all of the license agreements, click the appropriate option and then click Install.
- (Optional) Select the Run in the Background option to run the installation in the background.
- When the installation process is complete, click Finish.
Creating a Mobile Application with the SplashScreen Custom Component
Now that you have seen the SplashScreen component in action, let's go back
to the beginning and create this application. To create the application do the following:
- Create the SplashScreen project
- Add Packages and a Visual MIDlet to the Project
- Add components to MySplashScreenMidlet
- Change the Timeout Property of the SplashScreen Component
- Add Exit and Back Commands to the Form Component
- Add an Image Resource
- Bind an Image to a Component
- Connect the Components
- Run the Project
Creating the SplashScreen Project
- Choose File > New Project (Ctrl-Shift-N). Under Categories, select
Java ME. Under Projects, select Mobile Application and click Next.
SplashScreenExample in the Project Name field. Change
the Project Location to a directory on your system. This directory is called $PROJECTHOME.
- Uncheck the Create Hello MIDlet checkbox. Click Next.
- Leave the CLDC Oracle Java(TM) Platform Micro Edition SDK 3.0.5 as the selected Emulator Platform. Click
Adding Packages and a Visual MIDlet
to the Project
SplashScreenExample project in the Project Window,
then choose File > New File (Ctrl-N). Under Categories, select Java. Under File Types, select Java Package. Click Next.
splashscreenexample in the Package Name field. Click Finish.
- Choose the
splashscreenexample package in the Project window, then choose File > New File (Ctrl-N). Under Categories, select MIDP.
Under File Types, select Visual MIDlet. Click Next.
MySplashScreenMIDlet into MIDlet Name and MIDP Class Name fields. Click Finish.
Adding Components to MySplashScreenMidlet
- Switch your Visual MIDlet to the Flow Designer. Drag the following
Screen components from the Palette and drop them in the Flow Designer:
The Flow Designer with the added components should look as follows:
- Select the splashScreen component. In the Properties of this component,
change the Title to
Splash Screen and enter
10 sec. or press a key to close it into the Text property.
- Select the
form component and change its Title property to
- Double-click the
form component in the Flow Designer to switch
to the Screen Designer
- Select the StringItem component from the Items section of the Palette,
then drag and drop it into the
- Double-click stringItem inside the Screen Designer. Delete the stringItem title
Press Exit to close
Changing the Timeout Property of the SplashScreen Component
- Choose Flow at the top of the Visual Mobile Designer window to return to the Flow view.
- Select the
- In the Properties window find the Timeout property and change it from
5000 to 10000 milliseconds.
Adding the Exit Command to the Form Component
Choose the Exit Command from the Commands section of the Palette, and
drag it into the
Adding an Image Resource
Copy a *.png file
- Right-click the splashScreen component and choose Properties in the popup menu.
In the Properties dialog box, click the ellipsis button () against the Image property.
- In the Image dialog box, click Add.
image1 component is added.
- Click Browse and in the Open dialog box specify the path to the copied *.png file.
The image is added.
- Click OK to close the Open dialog box.
- Click Close to close the Properties dialog box.
The image is bound to the splashScreen component.
- In the Flow Designer, double-click the splashScreen component to open the Splash Screen in the Screen Designer.
It should look like the folowing screen:
In the Flow view, on Started on the Mobile Device and drag it to the splashScreen component. In the same manner, connect the components
as shown in the following graphic.
Running the Project
Press F6 to run the project. Alternatively you can select Run > Run Project from the main menu.
As the application runs, an emulator window opens and
displays the application running in the default device emulator.
Javadoc for the SplashScreen Component
The NetBeans IDE provides API Javadocs for the SplashScreen component, as well as other components you can use in the Visual Mobile Designer. To
read the Javadocs for the SplashScreen component:
- Place the cursor on the SplashScreen component in the source code and press Ctr-Shift-Space (or choose Source > Show Documentation).
The Javadoc for this element displays in a popup window.
- Click the Show documentation in external web browser icon () in the popup window to view the detailed information about the SplashScreen component in your browser.