org.openstreetmap.josm.gui.help

Class HelpBrowser

java.lang.Object

java.awt.Component

java.awt.Container

java.awt.Window

java.awt.Dialog

javax.swing.JDialog

org.openstreetmap.josm.gui.help.HelpBrowser

All Implemented Interfaces:

java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, javax.accessibility.Accessible, javax.swing.RootPaneContainer, javax.swing.WindowConstants, IHelpBrowser

public class HelpBrowser
extends javax.swing.JDialog
implements IHelpBrowser

Help browser displaying HTML pages fetched from JOSM wiki.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
(package private) static class	HelpBrowser.AbstractBrowserAction
(package private) static class	HelpBrowser.BackAction
(package private) static class	HelpBrowser.EditAction
(package private) static class	HelpBrowser.ForwardAction
(package private) static class	HelpBrowser.HomeAction
(package private) class	HelpBrowser.HyperlinkHandler
(package private) static class	HelpBrowser.OpenInBrowserAction
(package private) static class	HelpBrowser.ReloadAction

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

javax.swing.JDialog.AccessibleJDialog

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

java.awt.Dialog.AccessibleAWTDialog, java.awt.Dialog.ModalExclusionType, java.awt.Dialog.ModalityType

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

java.awt.Window.AccessibleAWTWindow, java.awt.Window.Type

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

Modifier and Type	Field and Description
private static JosmAction	focusAction
private JosmEditorPane	help the help browser
private HelpBrowserHistory	history the help browser history
private static HelpBrowser	instance the unique instance
private HelpContentReader	reader
private java.lang.String	url the currently displayed URL
private javax.swing.JMenuItem	windowMenuItem the menu item in the windows menu.

Fields inherited from class javax.swing.JDialog

accessibleContext, rootPane, rootPaneCheckingEnabled

Fields inherited from class java.awt.Dialog

DEFAULT_MODALITY_TYPE

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface javax.swing.WindowConstants

DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE

Fields inherited from interface java.awt.image.ImageObserver

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

Constructor Summary

Constructors

Constructor and Description
HelpBrowser() Constructs a new HelpBrowser.

Method Summary

Modifier and Type	Method and Description
protected void	build()
protected javax.swing.text.html.StyleSheet	buildStyleSheet() Builds the style sheet used in the internal help browser
protected javax.swing.JToolBar	buildToolBar()
HelpBrowserHistory	getHistory() Replies the browser history.
static HelpBrowser	getInstance() Replies the unique instance of the help browser
java.lang.String	getUrl() Replies the current URL.
protected void	handleHelpContentReaderException(java.lang.String relativeHelpTopic, HelpContentReaderException e) Displays a error page if a help topic couldn't be loaded because of network or IO error.
protected void	handleMissingHelpContent(java.lang.String relativeHelpTopic) Displays a warning page when a help topic doesn't exist yet.
static void	launchBrowser(java.lang.String helpTopic) Launches the internal help browser and directs it to the help page for helpTopic.
protected void	loadAbsoluteHelpTopic(java.lang.String absoluteHelpTopic) Loads a help topic given by an absolute help topic name, i.e.
protected void	loadRelativeHelpTopic(java.lang.String relativeHelpTopic) Loads a help topic given by a relative help topic name (i.e.
protected void	loadTopic(java.lang.String content)
void	openHelpTopic(java.lang.String relativeHelpTopic) Loads and displays the help information for a help topic given by a relative help topic name, i.e.
void	openUrl(java.lang.String url) Opens an URL and displays the content.
static void	setUrlForHelpTopic(java.lang.String helpTopic) Show the help page for help topic helpTopic.
void	setVisible(boolean visible)

Methods inherited from class javax.swing.JDialog

addImpl, createRootPane, dialogInit, getAccessibleContext, getContentPane, getDefaultCloseOperation, getGlassPane, getGraphics, getJMenuBar, getLayeredPane, getRootPane, getTransferHandler, isDefaultLookAndFeelDecorated, isRootPaneCheckingEnabled, paramString, processWindowEvent, remove, repaint, setContentPane, setDefaultCloseOperation, setDefaultLookAndFeelDecorated, setGlassPane, setJMenuBar, setLayeredPane, setLayout, setRootPane, setRootPaneCheckingEnabled, setTransferHandler, update

Methods inherited from class java.awt.Dialog

addNotify, getModalityType, getTitle, hide, isModal, isResizable, isUndecorated, setBackground, setModal, setModalityType, setOpacity, setResizable, setShape, setTitle, setUndecorated, show, toBack

Methods inherited from class java.awt.Window

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBackground, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getToolkit, getType, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, paint, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeNotify, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, setType, toFront

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, 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, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Field Detail

instance

private static HelpBrowser instance

the unique instance

windowMenuItem

private javax.swing.JMenuItem windowMenuItem

the menu item in the windows menu. Required to properly hide on dialog close

help

private JosmEditorPane help

the help browser

history

private transient HelpBrowserHistory history

the help browser history

url

private java.lang.String url

the currently displayed URL

reader

private final transient HelpContentReader reader

focusAction

private static final JosmAction focusAction

Constructor Detail

HelpBrowser

public HelpBrowser()

Constructs a new HelpBrowser.

Method Detail

getInstance

public static HelpBrowser getInstance()

Replies the unique instance of the help browser

Returns:

the unique instance of the help browser

setUrlForHelpTopic

public static void setUrlForHelpTopic(java.lang.String helpTopic)

Show the help page for help topic helpTopic.

Parameters:

helpTopic - the help topic

launchBrowser

public static void launchBrowser(java.lang.String helpTopic)

Launches the internal help browser and directs it to the help page for helpTopic.

Parameters:

helpTopic - the help topic

buildStyleSheet

protected javax.swing.text.html.StyleSheet buildStyleSheet()

Builds the style sheet used in the internal help browser

Returns:

the style sheet

buildToolBar

protected javax.swing.JToolBar buildToolBar()

build

protected final void build()

setVisible

public void setVisible(boolean visible)

Overrides:

setVisible in class java.awt.Dialog

loadTopic

protected void loadTopic(java.lang.String content)

getUrl

public java.lang.String getUrl()

Description copied from interface: IHelpBrowser

Replies the current URL.

Specified by:

getUrl in interface IHelpBrowser

Returns:

the current URL

handleMissingHelpContent

protected void handleMissingHelpContent(java.lang.String relativeHelpTopic)

Displays a warning page when a help topic doesn't exist yet.

Parameters:

relativeHelpTopic - the help topic

handleHelpContentReaderException

protected void handleHelpContentReaderException(java.lang.String relativeHelpTopic,
                                                HelpContentReaderException e)

Displays a error page if a help topic couldn't be loaded because of network or IO error.

Parameters:

relativeHelpTopic - the help topic

e - the exception

loadRelativeHelpTopic

protected void loadRelativeHelpTopic(java.lang.String relativeHelpTopic)

Loads a help topic given by a relative help topic name (i.e. "/Action/New") First tries to load the language specific help topic. If it is missing, tries to load the topic in English.

Parameters:

relativeHelpTopic - the relative help topic

loadAbsoluteHelpTopic

protected void loadAbsoluteHelpTopic(java.lang.String absoluteHelpTopic)

Loads a help topic given by an absolute help topic name, i.e. "/De:Help/Action/New"

Parameters:

absoluteHelpTopic - the absolute help topic name

openUrl

public void openUrl(java.lang.String url)

Description copied from interface: IHelpBrowser

Opens an URL and displays the content. If the URL is the locator of an absolute help topic, help content is loaded from the JOSM wiki. Otherwise, the help browser loads the page from the given URL.

Specified by:

openUrl in interface IHelpBrowser

Parameters:

url - the url

openHelpTopic

public void openHelpTopic(java.lang.String relativeHelpTopic)

Description copied from interface: IHelpBrowser

Loads and displays the help information for a help topic given by a relative help topic name, i.e. "/Action/New".

Specified by:

openHelpTopic in interface IHelpBrowser

Parameters:

relativeHelpTopic - the relative help topic

getHistory

public HelpBrowserHistory getHistory()

Description copied from interface: IHelpBrowser

Replies the browser history.

Specified by:

getHistory in interface IHelpBrowser

Returns:

the browser history