The NC browser User Interface control class enables most of the toolbar
functions of the browser to be controlled from Java.

The class has been implemented as a subclass of Applet called NCApplet,
contained in the package acorn.applet.  Applets which wish to make use of
the control functions must subclass this class instead of Applet.  This
is not unreasonable as an applet must be aware of the browser to use
the functions.

Most of the control functions require the new version of the NC browser
(version 1.07), currently under development.  Functions which work
on the current version (1.06) are marked *.  All methods return a boolean
value which indicates whether the function was supported by the browser
containing the applet.

Methods
=======	
	
busy
----

	public void busy(boolean busy)
	
	This method controls the browser's busy status indicator (spinning
	NC logo).  A boolean value of true turns it on, and a boolean
	value of false turns it off.
	

openToolbar
-----------

	public boolean openToolbar(String name)
	
	Opens the toolbar named 'name'.
	
	
openPanel
---------

	public boolean openPanel(String name)
	public boolean openPanel(String name, String target)
	
	Opens the panel named 'name'.  An optional target can also be specified.
	Possible values are:
		
		- Favs           * opens 'hotlist' on <= 1.06
		- FavsDelete
		- HistoryAlpha   * opens 'history' on <= 1.06
		- HistoryRecent  * opens 'history' on <= 1.06
		- Info            
		- Related
		
openPage
--------

	public boolean openPage(String name)
	public boolean openPage(String name, String target)
	
	Opens the panel named 'name'.  An optional target can also be specified.
	Possible values are:
	
		- Home   *
		- Search
		- Offline 

		
printPage
---------

	public boolean printPage(String size)
	public boolean printPage(String size, String source)
	
	Prints a page.  A source frame can be specified in the second version
	of the method.  The first prints the top level frame.

	
backPage
--------

	public boolean backPage()  *

	
forwardPage
-----------

	public boolean forwardPage()

	
stopPage
--------

	public boolean stopPage()
	
	Stops the load of the current page.

	
reloadPage
----------

	public boolean reloadPage()

	
showKeyboard
------------

	public boolean showKeyboard()

	This shows the on-screen keyboard.
	
	
favsAdd
-------

	public boolean favsAdd()
	public boolean favsAdd(String source)
	
	Adds the page in the top level frame (or the specified source) to
	the favourites.

	
favsRemove
----------

	public boolean favsRemove()
	public boolean favsRemove(String source)
	
	Removes the page in the top level frame (or the specified source) from
	the favourites.

	
getUAVersion
------------

	public int getUAVersion()
	
	This method returns the User Agent (i.e. browser) version number.
	Version numbers are in the form x.yy. This returns them as an
	int, multiplyed by 100 (i.e. 1.06 -> 106).

	
getAPIVersion
-------------

        public int getAPIVersion()

        Returns the API version number.
        

getFocus
--------

	public boolean getFocus()
	
	This transfers the input focus to the applet.

releaseFocus
------------

	public void releaseFocus()
	
	This transfers the input focus back to the browser.
