oracle.help.htmlBrowser

Class ICEBrowser

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

oracle.help.htmlBrowser.ICEBrowser

All Implemented Interfaces:

java.awt.image.ImageObserver, java.awt.MenuContainer, java.beans.PropertyChangeListener, java.io.Serializable, java.util.EventListener, javax.accessibility.Accessible, HTMLBrowser

public class ICEBrowser
extends javax.swing.JPanel
implements HTMLBrowser, java.beans.PropertyChangeListener

ICEBrowser implements the HTMLBrowser interface based on Oracle's modified version of ICESoft AS's ICE Browser which has been licensed for use with Oracle Help for Java.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JPanel

javax.swing.JPanel.AccessibleJPanel

Nested classes/interfaces inherited from class javax.swing.JComponent

javax.swing.JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

Fields inherited from class javax.swing.JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor and Description
ICEBrowser() Creates an instance of ICEBrowser.

Method Summary

Modifier and Type	Method and Description
void	addPopupListener(oracle.help.htmlBrowser.PopupListener listener) Adds a popup listener.
void	addProtocolListener(oracle.help.htmlBrowser.ProtocolListener listener) Adds a ProtocolListener.
void	addURLListener(oracle.help.htmlBrowser.URLListener listener) Adds a url listener.
boolean	canGoBack() Determines whether it is possible to move backward
boolean	canGoForward() Determines whether it is possible to move forward in the stack.
void	clear() Instructs the HTMLBrowser to clear the display of any loaded HTML
void	decreaseFontSize() Decreases the font size used by the TopicDisplay
void	dispose() Disposes HTMLBrowser resources
java.lang.String	getCharset() Gets the HTML character encoding.
java.lang.String	getCurrentPageTitle() Returns the title of the page currently viewed in the browser
java.awt.Dimension	getCurrentRenderedSize() Returns the size of the rendered document.
oracle.help.htmlBrowser.FindSupport	getFindSupport() Returns the FindSupport implementation for this HTMLBrowser implementation (or null if the browser does not support this feature)
javax.swing.JPanel	getHTMLContainer() Returns an LWContainer containing the HTMLBrowser if possible, null otherwise.
java.util.Locale	getLocale() Gets the Locale set on the HTMLBrowser.
java.awt.print.Printable	getPrintable(java.net.URL[] urls) Get the printable to be printed for the specified URLs
java.lang.String	getSelectedText() Gets the text highlighted in the TopicDisplay
java.net.URL	getURL() Gets the current Url.
void	goBack() Goes back
void	goForward() Goes forward in the stack.
void	increaseFontSize() Increases the font size used by the TopicDisplay
boolean	isPrintingSupported() Determines if printing is supported;
void	printURL(java.net.URL url) Print the HTML page at the given URL
void	printURLs(java.net.URL[] urls) Prints the HTML pages given (in book form if possible)
void	propertyChange(java.beans.PropertyChangeEvent e) PropertyChangeListener implementation to dispatch ChangeUrl events.
void	reloadURL() Reloads the current document.
void	removePopupListener(oracle.help.htmlBrowser.PopupListener listener) Removes a popup listener.
void	removeProtocolListener(oracle.help.htmlBrowser.ProtocolListener listener) Removes a ProtocolListener.
void	removeURLListener(oracle.help.htmlBrowser.URLListener listener) Removes a url listener.
void	runFindDialog() Runs the FindDialog via CTRL-F and Tools|Find menu seaches.
void	selectAll() Selects all the text in the browser window
void	setCharset(java.lang.String charset) Sets the character encoding to be used when loading URLs.
void	setDefaultBackground(java.awt.Color bgcolor) Sets the default background color for HTML pages.
void	setDefaultLinkForeground(java.awt.Color linkfg) Sets the default foreground color for links on HTML pages.
void	setDefaultTextForeground(java.awt.Color textfg) Sets the default foreground color for plain text on HTML pages.
void	setLocale(java.util.Locale aLocale) Sets the Locale on the HTMLBrowser, if possible.
void	setURL(java.net.URL url) Sets the ICEBrowser URL to be the specified URL.
void	setURL(java.net.URL url, boolean waitForRendering) Sets the HTMLBrowser URL to the specified URL.

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

ICEBrowser

public ICEBrowser()

Creates an instance of ICEBrowser.

Method Detail

setURL

public void setURL(java.net.URL url)

Sets the ICEBrowser URL to be the specified URL.

Specified by:

setURL in interface HTMLBrowser

Parameters:

url - is the URL to be displayed

setURL

public void setURL(java.net.URL url,
                   boolean waitForRendering)

Sets the HTMLBrowser URL to the specified URL. If waitForRendering is set to true, the method will render the HTML page synchronously (if the underlying browser permits).

Specified by:

setURL in interface HTMLBrowser

Parameters:

url - is the URL to be displayed

waitForRendering - if true the page will be rendered synchronously (if the underlying browser permits).

clear

public void clear()

Instructs the HTMLBrowser to clear the display of any loaded HTML

Specified by:

clear in interface HTMLBrowser

getPrintable

public java.awt.print.Printable getPrintable(java.net.URL[] urls)

Description copied from interface: HTMLBrowser

Get the printable to be printed for the specified URLs

Specified by:

getPrintable in interface HTMLBrowser

getURL

public java.net.URL getURL()

Gets the current Url.

Specified by:

getURL in interface HTMLBrowser

Returns:

The current URL.

reloadURL

public void reloadURL()

Reloads the current document.

Specified by:

reloadURL in interface HTMLBrowser

isPrintingSupported

public boolean isPrintingSupported()

Determines if printing is supported;

Specified by:

isPrintingSupported in interface HTMLBrowser

Returns:

true if printing support; false otherwise;

printURL

public void printURL(java.net.URL url)

Print the HTML page at the given URL

Specified by:

printURL in interface HTMLBrowser

Parameters:

url - the URL to be printed

printURLs

public void printURLs(java.net.URL[] urls)

Prints the HTML pages given (in book form if possible)

Specified by:

printURLs in interface HTMLBrowser

Parameters:

urls - the URL[] to be printed

getHTMLContainer

public javax.swing.JPanel getHTMLContainer()

Returns an LWContainer containing the HTMLBrowser if possible, null otherwise.

Specified by:

getHTMLContainer in interface HTMLBrowser

getCurrentRenderedSize

public java.awt.Dimension getCurrentRenderedSize()

Returns the size of the rendered document.

Specified by:

getCurrentRenderedSize in interface HTMLBrowser

addURLListener

public void addURLListener(oracle.help.htmlBrowser.URLListener listener)

Adds a url listener. All the registered URLListeners will be notified when the current page is replaced by a new page. This can happen when user selects a HTML link in the current page or when help requests HTMLBrowser to show a document.

Specified by:

addURLListener in interface HTMLBrowser

Parameters:

listener - URLListener to be added.

removeURLListener

public void removeURLListener(oracle.help.htmlBrowser.URLListener listener)

Removes a url listener.

Specified by:

removeURLListener in interface HTMLBrowser

Parameters:

listener - URLListener to be removed.

addPopupListener

public void addPopupListener(oracle.help.htmlBrowser.PopupListener listener)

Adds a popup listener. All the registered PopupListeners will be notified when user activates the popupTrigger. PopupTrigger is usually activated through right mouse click.

Specified by:

addPopupListener in interface HTMLBrowser

Parameters:

listener - PopupListener to be added

removePopupListener

public void removePopupListener(oracle.help.htmlBrowser.PopupListener listener)

Removes a popup listener.

Specified by:

removePopupListener in interface HTMLBrowser

Parameters:

listener - PopupListener to be removed.

getFindSupport

public oracle.help.htmlBrowser.FindSupport getFindSupport()

Returns the FindSupport implementation for this HTMLBrowser implementation (or null if the browser does not support this feature)

Specified by:

getFindSupport in interface HTMLBrowser

Returns:

runFindDialog

public void runFindDialog()

Runs the FindDialog via CTRL-F and Tools|Find menu seaches.

Specified by:

runFindDialog in interface HTMLBrowser

getCharset

public java.lang.String getCharset()

Gets the HTML character encoding. This is required for supporting internationalization in Help.

Specified by:

getCharset in interface HTMLBrowser

Returns:

HTML character encoding

setCharset

public void setCharset(java.lang.String charset)

Sets the character encoding to be used when loading URLs. This is required for supporting internationalization in Help.

Specified by:

setCharset in interface HTMLBrowser

Parameters:

charset - A java supported character encoding

getLocale

public java.util.Locale getLocale()

Gets the Locale set on the HTMLBrowser.

Specified by:

getLocale in interface HTMLBrowser

Overrides:

getLocale in class java.awt.Component

Returns:

HTML character encoding

setLocale

public void setLocale(java.util.Locale aLocale)

Sets the Locale on the HTMLBrowser, if possible.

Specified by:

setLocale in interface HTMLBrowser

Overrides:

setLocale in class java.awt.Component

Parameters:

charset - A java supported character encoding

propertyChange

public void propertyChange(java.beans.PropertyChangeEvent e)

PropertyChangeListener implementation to dispatch ChangeUrl events.

Specified by:

propertyChange in interface java.beans.PropertyChangeListener

Parameters:

e - The event for the property change

setDefaultBackground

public void setDefaultBackground(java.awt.Color bgcolor)

Sets the default background color for HTML pages. This is required for full support of window types.

Specified by:

setDefaultBackground in interface HTMLBrowser

Parameters:

bgcolor - The new default background color

setDefaultTextForeground

public void setDefaultTextForeground(java.awt.Color textfg)

Sets the default foreground color for plain text on HTML pages. This is required for full support of window types.

Specified by:

setDefaultTextForeground in interface HTMLBrowser

Parameters:

textfg - The new default text foreground color

setDefaultLinkForeground

public void setDefaultLinkForeground(java.awt.Color linkfg)

Sets the default foreground color for links on HTML pages. This is required for full support of window types.

Specified by:

setDefaultLinkForeground in interface HTMLBrowser

Parameters:

linkfg - The new default link foreground color

addProtocolListener

public void addProtocolListener(oracle.help.htmlBrowser.ProtocolListener listener)

Adds a ProtocolListener. All the registered listeners will be notified when a special protocol link is clicked on in the HTML browser.

Specified by:

addProtocolListener in interface HTMLBrowser

Parameters:

listener - ProtocolListener to be added.

removeProtocolListener

public void removeProtocolListener(oracle.help.htmlBrowser.ProtocolListener listener)

Removes a ProtocolListener.

Specified by:

removeProtocolListener in interface HTMLBrowser

Parameters:

listener - Listener to be removed.

canGoBack

public boolean canGoBack()

Determines whether it is possible to move backward

Specified by:

canGoBack in interface HTMLBrowser

Returns:

true if possible; false otherwise;

goBack

public void goBack()

Goes back

Specified by:

goBack in interface HTMLBrowser

canGoForward

public boolean canGoForward()

Determines whether it is possible to move forward in the stack.

Specified by:

canGoForward in interface HTMLBrowser

Returns:

true if possible; false otherwise;

goForward

public void goForward()

Goes forward in the stack.

Specified by:

goForward in interface HTMLBrowser

getSelectedText

public java.lang.String getSelectedText()

Gets the text highlighted in the TopicDisplay

Specified by:

getSelectedText in interface HTMLBrowser

increaseFontSize

public void increaseFontSize()

Increases the font size used by the TopicDisplay

Specified by:

increaseFontSize in interface HTMLBrowser

decreaseFontSize

public void decreaseFontSize()

Decreases the font size used by the TopicDisplay

Specified by:

decreaseFontSize in interface HTMLBrowser

selectAll

public void selectAll()

Selects all the text in the browser window

Specified by:

selectAll in interface HTMLBrowser

getCurrentPageTitle

public java.lang.String getCurrentPageTitle()

Returns the title of the page currently viewed in the browser

Specified by:

getCurrentPageTitle in interface HTMLBrowser

dispose

public void dispose()

Disposes HTMLBrowser resources

Specified by:

dispose in interface HTMLBrowser