Enhanced AWT RI

---

The Enhanced AWT RI has a user interface tailored for a device with a VGA (640x480) touchscreen, such as a Web tablet, and can be used as a starting point for developing an embedded application.

Instead of using many command line options, it offers an options panel in its GUI. It also has tabs to switch between open browser windows. The RI uses a custom AWT extension widget set to provide skinnable GUI components; for more information, see ICEsoft Skinnable Component Library.

This RI uses certain features if the libraries are present. For example, the ICEsoft HTTP implementation is used if the ib6http.jar file is on the classpath.

Figure 2-3 Enhanced AWT RI

Starting the Enhanced AWT RI

To run the Enhanced AWT RI:

1. Ensure that JDK 1.1.8 or higher is installed.
2. Add the relevant JAR files to the classpath. You need at least the following:

   ri_enhancedawt.jar
   ib6core.jar
   ib6util.jar
   ib6http.jar

   To enable optional capabilities, such as extra media support, HTTPS, or SSL, add the required JARs as described in JAR Files (lib).

3. Run java ice.ri.enhancedawt.browser.Main

Configuration of this RI is primarily handled in the application GUI. However, you can specify the starting size on the command line.

For example, to run the Enhanced AWT RI with JavaScript, HTTPS, and extra media support enabled, and with a starting size of 640 x 480:

java -classpath ri_enhancedawt.jar;ib6core.jar;ib6util.jar;

  ib6extra.jar;ib6http.jar;ib6https.jar;icessl.jar

  ice.ri.enhancedawt.browser.Main -w640 -h480
 

Starting as an Executable JAR

The ri_enhancedawt.jar file is an executable JAR, so you can also start the Enhanced AWT RI with JDK 1.3.1 or greater as follows:

java -jar ri_enhancedawt.jar
 

Settings Directory

The Enhanced AWT RI stores its settings in the directory <user_dir>/ICEsoft/EnhancedAWTRI/, where <user_dir> is the platform-specific directory specified by the user.home system property.

PAC Support

The Enhanced AWT RI also has built-in PAC support. To use it, set the com.icesoft.pac property:

java -Dcom.icesoft.pac=file:///c:/proxy.pac 
ice.ri.enhancedawt.browser.Main
 

The com.icesoft.pac property is specific to the reference implementations. If the value is anything but null, PAC is used. The value is the URL of the PAC file.

Using the Enhanced AWT RI

Tabs

When several windows are active, a tab for each page is displayed near the top of the browser window. Click the tab to display the content of that window. The user interface also has the following buttons to control tab functions:

Button	Description
new	Opens a new browser window with its own tab.
X	Closes the active browser window.
Tabs	Toggles between showing and hiding tabs. Hiding the tabs leaves more room for displaying content.

Options Panel

The Options button opens a panel that has the following functions:

Option	Description
Emulation Mode	Sets the emulation mode. Some Web sites try to guess a browser's capabilities from its name. It can be an advantage to identify an application as another browser. This RI offers the following emulation modes: None - Runs without emulation (native ICEbrowser mode). ns6 - Netscape 6 mode. ie - MSIE mode. This is the default.
Home Page	Specifies the start page. The default is www.icesoft.com.
Search Page	Specifies the search page. The default is www.google.com.
Load Images	Specifies if images on pages are loaded. To display pages faster and save memory, you can view Web pages without loading their graphic images. To do this, deselect Load Images. For some sites, disabling images may cause unexpected behavior.
Proxy Settings	Specifies if a proxy server is used.
Proxy Port	Specifies the proxy port.
Proxy Host	Specifies the proxy host.
Clear Cache	Clears the memory cache.
Clear Cookies	Removes all saved cookies.
Apply	Saves the current settings.
Close	Returns to the browser window.

Copyright 2005. ICEsoft Technologies, Inc. http://www.icesoft.com