eve.ui.formatted.data

Class HtmlViewer

java.lang.Object

eve.ui.ControlBase

eve.ui.Control

eve.ui.Container

eve.ui.Canvas

eve.ui.Panel

eve.ui.CellPanel

eve.ui.FormBase

eve.ui.Form

eve.ui.data.Editor

eve.ui.data.AppForm

eve.ui.formatted.data.HtmlViewer

All Implemented Interfaces:

HasProperties, IOwnable, Drawable, ImageRefresher, DataInterface, TimerProc, CellConstants, ControlConstants, FieldListener, HasAncestor, IScroll, LayoutManager, ScrollClient, UIConstants, EventListener

Direct Known Subclasses:

WebBrowser

public class HtmlViewer
extends AppForm

This is a useful Form that you can use to display HTML files. It consists of an HtmlDisplay along with optional controls.

The

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	HtmlViewer.HtmlViewerDisplay

Nested classes/interfaces inherited from class eve.ui.Form

Form.FormMaker, Form.ToolsOrSoftKey, Form.ValidateBeforeExit

Field Summary

Fields

Modifier and Type	Field and Description
boolean	animatedImages Specifies if animated images should be allowed - true on some systems by default.
TextCodec	codec This is the codec that will be used to decode text.
static int	DISPLAY_NO_OPEN A display option for the constructor.
static int	DISPLAY_NO_STATUS_BAR A display option for the constructor.
static int	DISPLAY_NO_TABS A display option for the constructor.
static int	DISPLAY_NO_TOOL_BUTTONS A display option for the constructor.
FontChooser	fontChooser
PropertyList	htmlProperties
static String[]	images
protected Handle	loading
protected ProgressDisplay	progress
boolean	showImages Specifies if images should be displayed - true by default.
String	status
protected CardPanel	statusCard
protected Control	stopButton

Fields inherited from class eve.ui.data.AppForm

chosenMenuItem, data, isAutoExpandingTabs, menus, SHOW_EXIT_BUTTON, SHOW_NEW_BUTTON, SHOW_OPEN_BUTTON, SHOW_SAVE_AS_BUTTON, SHOW_SAVE_BUTTON, tabs, tools

Fields inherited from class eve.ui.data.Editor

autoRefreshControls, coroutineStackSize, currentEvent, DoDataTransfer, dontAddSoftkeysAsActions, fieldListeners, fieldsWillNotBeAdded, myObject, objectClass, sampleObject, transferOnAdding, transfers

Fields inherited from class eve.ui.Form

acceptsDroppedFiles, apply, back, buttons, BUTTONS_TO_SOFT_KEY_FIRST_BUTTON_SEPARATE, BUTTONS_TO_SOFT_KEY_MENU_ALWAYS, BUTTONS_TO_SOFT_KEY_USE_FIRST_SOFT_KEY, buttonsPanel, buttonsPerRow, cancel, CLOSING_FLAG, deflt, dismantleOnClose, dontAddSIPFiller, exitButtonDefined, EXITING_FLAG, exitSystemOnClose, exitValue, firstFocus, formFrame, frameAlpha, handle, hasTitle, hasTopBar, hideSoftKeyBarIfNotFound, inheritSoftKeys, isAutoScrolling, isMainAppletForm, keepFrame, minimumShowTime, moveable, no, noBorder, ok, pl, reset, resizable, resizeOnSIP, shadowed, SHOWN_FLAG, shownTime, softkeyBars, title, titleCancel, titleControls, titleOK, topControls, WINDOW_TITLE_DONT_CHANGE, windowFlagsToClear, windowFlagsToSet, windowIcon, windowTitle, yes

Fields inherited from class eve.ui.FormBase

BACKB, CANCELB, checkIcon, close, cross, crossIcon, DEFCANCELB, DEFOKB, EXIT_IDBACK, EXIT_IDCANCEL, EXIT_IDNO, EXIT_IDOK, EXIT_IDYES, IDBACK, IDCANCEL, IDNO, IDOK, IDYES, MBB, MBNONE, MBOK, MBOKCANCEL, MBYESNO, MBYESNOCANCEL, NOB, OKB, stop, tick, YESB

Fields inherited from class eve.ui.CellPanel

autoSpan, layout, mySplitter, nextSplitter, quickRecalculate

Fields inherited from class eve.ui.Panel

all, calculated, childListeners, defaultAddToMeCellConstraints, defaultTags, equalHeights, equalWidths, grid, lastAdded, layoutManager, made, noInsets, stretchFirstColumn, stretchFirstRow, stretchLastColumn, stretchLastRow, titleGap

Fields inherited from class eve.ui.Canvas

isFullScrollClient, origin, scrollPercent, virtualSize

Fields inherited from class eve.ui.Container

closedFocus, cycleFocus, dontAutoScroll, dontFocusOnChildren, FIND_FOR_MOUSE_PRESS, takeNextFocus

Fields inherited from class eve.ui.Control

backGround, beforeRemoved, borderColor, borderStyle, borderWidth, children, columns, constraints, curFont, debugModify, debugRepaintNow, disabledBackground, dragging, dragResolution, dragTime, exitKeys, fieldTransfer, font, fontChange, fontFrom, foreGround, height, holdDownPause, holdTick, hotKey, image, lastSelected, listeners, lockPaint, maxHeight, maxWidth, menuState, minHeight, minWidth, modifiers, name, next, parent, penStatus, preferredHeight, preferredWidth, prev, prompt, promptControl, rows, ss, startDragResolution, tags, tail, text, toolTip, width, x, y

Fields inherited from class eve.ui.ControlBase

clipItems, clipObject, clipOwner, debugControl, debugFlag, doubleBuffer, doubleClickTime, doubleSizedFontHeight, firstPress, globalEditable, globalEnabled, PEN_STATUS_DID_HOLD_DOWN, PEN_STATUS_GOT_PEN_DOWN, PEN_STATUS_PEN_IS_ON, pressPoint, TAG_BOOLEAN_KEEP_BELOW_SIP, TAG_HOVER_TIME_INT, TAG_LAST_USER_DATA, TAG_USER_DATA, TAKE_FIRST_PRESS, unnamed

Fields inherited from interface eve.ui.CellConstants

ALWAYS_STRETCHABLE, BOTTOM, CELLFLAG, CELLMASK, CENTER, CONTROLMASK, DONTCHANGE, DONTFILL, DONTSTRETCH, EAST, FILL, GROW, HCENTER, HCONTRACT, HEXPAND, HFILL, HGROW, HSHRINK, HSTRETCH, INITIALLY_CLOSED, INITIALLY_HIDDEN, INITIALLY_MINIMIZED, INITIALLY_PREFERRED_SIZE, INSETS, LEFT, MAXIMUMSIZE, MINIMUMSIZE, NORTH, NORTHEAST, NORTHWEST, PREFERREDSIZE, RECT, RIGHT, SHRINK, SOUTH, SOUTHEAST, SOUTHWEST, SPAN, STRETCH, TAG_BACKGROUND_IMAGE, TAG_BUSY_DISPLAY, TAG_COLORS, TAG_CONTROL_PAINTER, TAG_EXPOSE_GROUP, TAG_FIXEDSIZE, TAG_GRAY_BACKGROUND, TAG_HIDE_CONTROL_OBJECT, TAG_HIDE_PARENT, TAG_INNER_TEXT_INSETS, TAG_INPUT_STACK_PARENT, TAG_INSETS, TAG_MAKE_VISIBLE, TAG_MAXIMUMSIZE, TAG_MINIMUMSIZE, TAG_PAINT_CONTROL_LIST, TAG_PREFERRED_TEXT_SIZE, TAG_PREFERRED_TEXT_SIZE_HEIGHT, TAG_PREFERRED_TEXT_SIZE_WIDTH, TAG_PREFERREDSIZE, TAG_RECT, TAG_SHADOW_INSETS, TAG_SPAN, TAG_SWIPER, TAG_TEMPORARY_ERROR, TAG_TEXT_INSETS, TAG_TEXTSIZE, TEXTSIZE, TOP, VCENTER, VCONTRACT, VEXPAND, VFILL, VGROW, VSHRINK, VSTRETCH, WEST

Fields inherited from interface eve.ui.IScroll

GoHigher, GoLower, Horizontal, OPTION_INDICATOR_ONLY, PageHigher, PageLower, ScrollHigher, ScrollLower, TrackTo, Vertical

Fields inherited from interface eve.ui.UIConstants

BDR_DOTTED, BDR_INNER, BDR_NOBORDER, BDR_OUTER, BDR_OUTLINE, BDR_RAISEDINNER, BDR_RAISEDOUTER, BDR_SUNKENINNER, BDR_SUNKENOUTER, BF_ABUT_ANY, BF_ABUT_BOTTOM, BF_ABUT_LEFT, BF_ABUT_RIGHT, BF_ABUT_TOP, BF_BOTTOM, BF_BOTTOMLEFT, BF_BOTTOMRIGHT, BF_BUTTON, BF_DIAGONAL, BF_DIAGONAL_ENDBOTTOMLEFT, BF_DIAGONAL_ENDBOTTOMRIGHT, BF_DIAGONAL_ENDTOPLEFT, BF_DIAGONAL_ENDTOPRIGHT, BF_EXACT, BF_FLAT, BF_LEFT, BF_MIDDLE, BF_MONO, BF_PALM, BF_RECT, BF_RIGHT, BF_SOFT, BF_SQUARE, BF_TOP, BF_TOPLEFT, BF_TOPRIGHT, EDGE_BUMP, EDGE_ETCHED, EDGE_RAISED, EDGE_SUNKEN

Fields inherited from interface eve.ui.ControlConstants

All, AlwaysEnabled, AlwaysRecalculateSizes, ByDeferredMouse, ByDeferredPen, ByFrameChange, ByKeyboard, ByMouse, ByPen, ByRequest, CalculatedSizes, ContainerDontPaintChildren, Disabled, DisablePopupMenu, DisplayOnly, DontBuffer, Down, DrawFlat, Flag, ForceResize, HasData, Invisible, KeepImage, KeepSIP, Left, MakeMenuAtLeastAsWide, Maximize, Minimize, ModifiersInheritedFromWindow, MouseSensitive, NoFocus, NotAnEditor, NotEditable, PaintDataOnly, PaintOutsideOnly, PenTransparent, PreferredSizeOnly, Right, SendUpUIEvents, ShowSIP, ShrinkToNothing, SmallControl, TakeChildUIEvents, TakeControlEvents, TakesKeyFocus, Transparent, Up, WantDrag, WantHoldDown

Fields inherited from interface eve.fx.ImageRefresher

KEEP_VISIBLE

Fields inherited from interface eve.fx.Drawable

ACTIVE, DISABLED, INACTIVE, INDENT_ITEM_FLAG, OUTLINED

Constructor Summary

Constructors

Constructor and Description
HtmlViewer() Create the viewer with full tools.
HtmlViewer(HtmlDisplay display, int displayOptions) Create the viewer with a particular HtmlDisplay and using the specified display options.
HtmlViewer(int displayOptions) Create the viewer the specified display options.

Method Summary

Modifier and Type	Method and Description
void	action(String fieldName, Editor ed) This gets called by action(FieldTransfer ft,Editor ed) and by fieldChanged(FieldTransfer ft,Editor ed) if the field changed is a menu item.
protected void	addPropertiesTo(PropertyList pl)
FormattedTextMaker	cacheOpened(String name, FormattedTextMaker maker)
void	cancelLoading(boolean startingNewLoad) Use this to cancel a load/decode operation.
protected HtmlDisplay	createDisplay()
Handle	doOpen(String fileOrUrl) Open the file relative to the current document root, or as a new document/file.
protected void	endedLoad(Handle h)
void	fieldChanged(String fieldName, Editor ed) This gets called by fieldChanged(FieldTransfer ft,Editor ed).
void	filesDropped(String[] fileName) This is called when files are dropped on the Form and acceptsDroppedFiles is true.
FormattedTextMaker	findCached(String name)
TextCodec	getCodec(PropertyList pl) Get a codec to decode a Web document.
String	getCurrentURL()
void	goBack() Go to previous document/location.
protected boolean	hotspotPressed(HotSpot hs, Point where)
static void	main(String[] args)
protected void	newDocumentLoaded(String url)
protected void	noLoading()
void	open() Open a new file.
void	open(FormattedTextMaker maker)
FormattedTextMaker	open(String name)
FormattedTextMaker	open(String data, String fileName)
static HtmlViewer	openAndDisplay(String url, int displayOptions, boolean execute)
protected Handle	openDocument(String url, PropertyList pl)
void	reload() Reload the current document.
void	removeCached(String name)
void	setDisplayFont(Font f) Set the display font.
void	setHtml(FormattedTextMaker html)
Handle	setHtml(Link link) Tell the viewer to load and display the Link.
Handle	setHtml(Object htmlText, String urlToDisplay, String bookmark) Set the Html text directly.
FormattedTextMaker	setHtml(String html, PropertyList props, Handle h)
Handle	setHtml(URL url) Tell the viewer to load and display the URL.
void	setupProperties() Setup the htmlProperties based on selected options.
protected void	startingLoad(Handle h)
protected String	toFullURL(String root, String document) This returns a String ONLY if the String is the name of a VALID URL resource.
void	update()

Methods inherited from class eve.ui.data.AppForm

addExpandingTool, addExpandingTool, addStandardFileMenu, addStandardFileMenu, addStandardFileMenu, addToolButton, addToolButton, getStandardFileCommands, setupStandardFileCommands, setupStandardFileCommands

Methods inherited from class eve.ui.data.Editor

action, addButtonAsAction, addExternalField, addExternalField, addField, addField, addField, addField, addMenuAsAction, addMenuItemAsAction, addSoftKeysAsActions, badField, canExit, changeField, convertData, dataChanged, dataChanged, dataObjectIsCompatible, dismantle, enableScrolling, fieldChanged, fieldEvent, findControlFor, findControlFor, findFields, findFieldTransfer, findFieldTransfer, findFieldTransfer, fireAction, fireFieldChanged, fireFieldEvent, fireFieldEvent, focusOn, formClosing, fromControls, fromControls, fromControls, fromControls, getData, getDataControls, getDataParentObject, getEditedObject, getEditedUnder, getEditorAndFieldValue, getFieldValue, getFieldValue, getProperty, getProperty, handleException, handleTransferError, invokeFieldHandlerMethod, make, modifyControl, modifyFields, modifyPropertiesOrFields, onControlEvent, onDataChangeEvent, onSoftKey, pauseCurrentEventThread, pauseThisEventThread, postEditorEvent, postEditorEvent, removeField, resumeCurrentEventThread, resumeThisEventThread, setData, setDataControls, setEditedObject, setFields, setFields, setObject, setProperty, shown, takeFieldFrom, toControls, toControls, toControls, toControls, transfer, transfer

Methods inherited from class eve.ui.Form

_getSetField, addButton, addFieldHandler, addFormMaker, addSIPAdjustment, addTabbedPanel, addToolbar, addTools, addToolsFor, addValidateBeforeExit, addValidateBeforeExit, buttonsToMenu, buttonsToSoftKeyBar, buttonsToSoftKeyBar, cancelWait, checkButtons, checkCanExit, close, closeAll, closeForTransfer, closeForTransfer, continueWait, createMenuItem, createMenuItem, createMenuItem, createSipFiller, createWindow, defaultTitleTo, doButtons, doShowExec, enableScrolling, exec, exec, exec, exec, exec, execute, execute, execute, exit, fixWindowTitle, formMain, fromFields, fromFields, fullScreenOnPDA, gatherButtons, getAncestorProperty, getButton, getFileSaver, getFormFrame, getFormWithProperty, getProperties, getSoftKeyBarFor, getTopmostForm, handleAction, handleAction, hasExitButton, makeButtonForForm, makeButtonForForm, makeDefaultButton, makeDefaultButton, makeFrame, makeMenuItemForForm, makeMenuItemForForm, makeSmall, makeSmallOnBigScreen, makeSoftKeys, makeSoftKeys, makeSoftKeys, maximizeOnPDA, menuItemSelected, modifyForSmartPhone, onEvent, onSoftKey, placeCancelOnLeft, removeSoftKeyBarFor, setAsMainAppletForm, setAsShown, setBelowButtonBar, setBelowButtonBars, setDefaultSize, setExitHandle, setFileSaver, setMainScrollBarPanel, setNoTitleBar, setSoftKeyBarFor, setSoftKeyBarForAll, setupFrame, show, show, showButtons, showExecCalled, showWait, showWait, startRunning, stopFormHandle, takeButtons, takeButtons, takeButtons, toFields, toFields, toolsOnBottom, validateBeforeExit, waitUntilClosed, waitUntilClosed, waitUntilClosed, waitUntilShown, willBeMaximized

Methods inherited from class eve.ui.FormBase

getCross, getParentObject, getParentObject, getSizedImage, getTick, getToolsIcon, setParentObject

Methods inherited from class eve.ui.CellPanel

calculateSizes, getFloatingControls, getSubControls, hasFloatingControls, makeLayoutGrid, relayoutMe, removeAll, reShow, resize, resizeTo

Methods inherited from class eve.ui.Panel

add, addChildListener, addDirectly, addLast, addLast, addLast, addNext, addNext, addNext, addNext, calculatedSizes, doBorder, endRow, getControlTag, getPreferredSize, insertRow, isEmpty, layout, remove, removeChildListener, sendToChildListeners, setAsBelowSip, setText

Methods inherited from class eve.ui.Canvas

canGo, canScreenScroll, checkScrolls, doScroll, fixOrigin, getActual, getBuffer, getCurrent, getDisplayedSize, getMyHeight, getMySize, getMyWidth, getPercent, getScrollablePanel, getScrollClient, getVisible, getVisibleArea, needScrollBar, onScroll, onSetOrigin, reduceClip, scroll, scroll, scrollToVisible, setOrigin, updateScrollServer

Methods inherited from class eve.ui.Container

add, completeAddPopupControl, containerHasFocus, dismantle, doHotKey, doPaint, findChild, findChild, focusFirst, focusFirst, focusOnContainer, focusOnData, getChildren, getFirstFocus, getNextKeyFocus, gotFocus, grayOut, hide, lostFocus, relayout, removePopupControl, repaintDataNow, setHidden, startAddPopupControl, takeFocus, takePromptControl, unhide

Methods inherited from class eve.ui.Control

acceptsData, activate, addListener, amOnTopFrame, applyFontChange, baseOnPenEvent, bufferGraphics, bufferGraphics, bufferGraphics, bufferGraphics, bufferGraphics, cache, calculateTextSize, calculateTextSize, calculateTextSize, cancelHoldDown, cancelPenPress, canEdit, change, changeDimension, changeTag, checkClipboardOperations, checkExitKey, checkMenu, checkMenuKey, checkModifiers, checkParentInterceptsUIEvent, checkPenTransparent, childrenPainted, clearTag, clipboardToString, clipboardTransfer, closeMenu, contains, contains, createNewMenu, dataAccepted, dataBeingRemoved, dataDraggedOff, dataDraggedOver, dataDraggedOver, dataDroppedOn, dataTransferCancelled, deactivate, defaultTo, deferInWindowThread, doAction, doActionKey, doBackground, doMenu, dontAcceptDrop, doPaintChildren, doPaintData, doPaintData, doShowMenu, dragged, draw, draw, draw, exitEntry, fillBackground, fillBackgroundNotInFrame, findTagInParents, fontChanged, free, fromClipboard, fromField, fromField, getAllDescendants, getAllSubControls, getAncestor, getAncestor, getAncestorProperty, getBackground, getCached, getCachedChildren, getCachedDim, getCachedDim, getCachedRect, getCachedRect, getCachedSubControls, getChildAnchor, getChildren, getChildrenBackwards, getClipboardMenu, getClipObject, getContentsInsets, getContentsInsets, getContentsRect, getDataToCopy, getDataToDragAndDrop, getDim, getDisplayText, getDragAndDropContext, getFieldTransfer, getFont, getFontMetrics, getFontMetrics, getFontMetricsForSizeCalculations, getForeground, getFrame, getFrameOrContainer, getGraphics, getGraphics, getHeight, getHideParent, getImage, getLastSelected, getLocation, getLock, getMaximumSize, getMenu, getMinimumSize, getModifiedBorderFlags, getModifiers, getNext, getPaintParameters, getParent, getParent, getParent, getParentOrListener, getPasswordCharacter, getPosInFrame, getPosInFrame, getPosInParent, getPosInParent, getPreferredSize, getPreferredSizeByParent, getPreferredTextSize, getPrompt, getPromptText, getRect, getRect, getServer, getSize, getSizes, getSubControls, getTag, getText, getToolTip, getWidth, getWindow, getWindowGraphics, hasModifier, hasPopupFormAttached, hasTag, hide, inheritModifiers, insetToContents, interceptChildUIEvent, isChildOf, isDirectChildOfWindow, isHidden, isModal, isOnMe, isOnMe, isOnMe, isSomeonesHotKey, makeFrameTopMost, makeHot, makeHot, makeInvisible, makeVisible, markAsTemporaryError, menuIsActive, menuStateChanged, modify, modifyAll, modifyAll, modifyFlags, mouseHover, newEventThread, notifyAction, notifyDataChange, notifyDataChange, notifyMenuItemSelected, notifyStructureChanged, onKeyEvent, onLabelPenEvent, onPenEvent, paintBackground, paintWithControlPainter, pauseEventThread, penClicked, penDoubleClicked, penHeld, penPressed, penReleased, penRightReleased, popupBeep, popupMenuClosed, popupMenuEvent, popupMenuEvent, postEvent, postInWindowThread, postUIEvent, putInside, queueKeyEvent, queuePenEvent, readLock, recalculatePreferredSize, redisplay, refresh, releaseBufferedGraphics, removed, removeListener, repaint, repaint, repaintInWindowThread, repaintInWindowThread, repaintNow, repaintNow, repaintNow, repaintNow, requestPaint, requestResizeTo, resetAllCachedProperties, resetCachedProperties, resetRect, restore, restoreBorderModifiers, restoreFlags, resumeEventThread, scrollAndRepaint, sendToListeners, set, setAllFonts, setBackgroundImage, setBorder, setBorderModifiers, setCell, setChildAnchor, setClipObject, setControl, setCursor, setFieldTransfer, setFixedSize, setFont, setFontChange, setFreeDragging, setHidden, setHiddenParent, setHotKey, setHotKey, setLocation, setMaximumSize, setMenu, setMinimumSize, setPreferredSize, setPreferredTextSize, setPreferredTextSize, setPromptControl, setRect, setRect, setScaledBackgroundImage, setServer, setShadow, setSwiping, setTag, setTags, setTextSize, setTiledBackgroundImage, setToolTip, showHoldDownIndicator, simulateClickOn, simulateKeyPresses, simulateKeyType, standardOnKeyEvent, startDragAndDrop, startDragAndDrop, startDragging, stopDragging, takeData, takeFromClipboard, testInWindowThread, ticked, tipIsDisplayed, toClipboard, toField, toField, toIDString, toString, toTextData, transferPenPress, transferPenPress, tryDragAndDrop, tryGetGraphics, tryNext, tryStartMenu, unhide, unlock, updateData, updateDCDuringDD, updateFrom, updateTo, verifyWantDrag, verifyWantHoldDown, waitEventThread, willAcceptDrop, willShowFrame, windowHasFloatingControls, writeLock

Methods inherited from class eve.ui.ControlBase

doubleSizeIt, getGuiTextHeight, isDoubleSized, isDoubleSizedFont, loadImage, tryLoadImage

Methods inherited from class java.lang.Object

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

Methods inherited from interface eve.ui.ScrollClient

getServer, setServer

Field Detail

htmlProperties

public PropertyList htmlProperties

fontChooser

public FontChooser fontChooser

showImages

public boolean showImages

Specifies if images should be displayed - true by default.

animatedImages

public boolean animatedImages

Specifies if animated images should be allowed - true on some systems by default.

DISPLAY_NO_STATUS_BAR

public static final int DISPLAY_NO_STATUS_BAR

A display option for the constructor.

See Also:

Constant Field Values

DISPLAY_NO_TOOL_BUTTONS

public static final int DISPLAY_NO_TOOL_BUTTONS

A display option for the constructor.

See Also:

Constant Field Values

DISPLAY_NO_TABS

public static final int DISPLAY_NO_TABS

A display option for the constructor.

See Also:

Constant Field Values

DISPLAY_NO_OPEN

public static final int DISPLAY_NO_OPEN

A display option for the constructor.

See Also:

Constant Field Values

status

public String status

progress

protected ProgressDisplay progress

stopButton

protected Control stopButton

statusCard

protected CardPanel statusCard

codec

public TextCodec codec

This is the codec that will be used to decode text. If it is null then an AsciiCodec will be used.

loading

protected Handle loading

images

public static String[] images

Constructor Detail

HtmlViewer

public HtmlViewer()

Create the viewer with full tools.

Parameters:

displayOptions - This can be any of the : DISPLAY_XXX options ORed together.

HtmlViewer

public HtmlViewer(int displayOptions)

Create the viewer the specified display options.

Parameters:

displayOptions - This can be any of the : DISPLAY_XXX options ORed together.

HtmlViewer

public HtmlViewer(HtmlDisplay display,
                  int displayOptions)

Create the viewer with a particular HtmlDisplay and using the specified display options.

Parameters:

display - An HtmlDisplay to use (can be null).

displayOptions - This can be any of: DISPLAY_NO_STATUS_BAR, DISPLAY_NO_TOOL_BUTTONS, DISPLAY_NO_TABS OR'ed together.

Method Detail

getCodec

public TextCodec getCodec(PropertyList pl)

Get a codec to decode a Web document. The properties of the document as provided by the Web Server are in the specified PropertyList parameter.

Parameters:

pl - the properties for the document.

Returns:

a non-null Codec for decoding the document. By default this returns the value of the "codec" field. If that is null an AsciiCodec is returned.

toFullURL

protected String toFullURL(String root,
                           String document)

This returns a String ONLY if the String is the name of a VALID URL resource. This could be a file name.

Parameters:

root - The current document root.

document - The document being referred to.

Returns:

the URL as a String if it is valid and can be retrieved by the Viewer.

openDocument

protected Handle openDocument(String url,
                              PropertyList pl)

hotspotPressed

protected boolean hotspotPressed(HotSpot hs,
                                 Point where)

noLoading

protected void noLoading()

startingLoad

protected void startingLoad(Handle h)

endedLoad

protected void endedLoad(Handle h)

getCurrentURL

public String getCurrentURL()

newDocumentLoaded

protected void newDocumentLoaded(String url)

setHtml

public Handle setHtml(URL url)

Tell the viewer to load and display the URL.

Parameters:

url - The url which can be an http:// url or a file name. It can also be relative to the current document.

Returns:

A Handle that can be used to monitor the progress of the display.

setHtml

public Handle setHtml(Link link)

Tell the viewer to load and display the Link. A Link can be a URL in text form or it can be a file name or an anchor ('#') to a bookmark in the current document.

Parameters:

link - The link which can be an "http://" url or a file name. It can also be relative to the current document.

Returns:

A Handle that can be used to monitor the progress of the display.

setHtml

public Handle setHtml(Object htmlText,
                      String urlToDisplay,
                      String bookmark)

Set the Html text directly.

Parameters:

htmlText - An object representing htmlText. This can be:

• A URL holding the URL you want the browser to fetch.
• A Link holding the URL or file that you want the browser to fetch.
• A String holding the HTML text.
• An eve.util.ByteArray holding the text encoded HTML text.
• A byte array (byte[]) holding the text encoded HTML.
• An InputStream object from which the text can be read.
• An eve.io.File object from which the text can be read.

urlToDisplay - The URL to display for the data.

bookmark - An optional bookmark in the file to go to.

Returns:

A Handle that can be used to monitor the progress of the display.

setupProperties

public void setupProperties()

Setup the htmlProperties based on selected options.

cancelLoading

public void cancelLoading(boolean startingNewLoad)

Use this to cancel a load/decode operation. If you intend to immediately start another load using doOpen() then set startingNewLoad to true.

doOpen

public Handle doOpen(String fileOrUrl)

Open the file relative to the current document root, or as a new document/file.

Parameters:

fileOrUrl. -

Returns:

A Handle with which the progress of the load can be monitored.

createDisplay

protected HtmlDisplay createDisplay()

setHtml

public void setHtml(FormattedTextMaker html)

setHtml

public FormattedTextMaker setHtml(String html,
                                  PropertyList props,
                                  Handle h)

addPropertiesTo

protected void addPropertiesTo(PropertyList pl)

open

public FormattedTextMaker open(String data,
                               String fileName)

open

public void open(FormattedTextMaker maker)

findCached

public FormattedTextMaker findCached(String name)

cacheOpened

public FormattedTextMaker cacheOpened(String name,
                                      FormattedTextMaker maker)

removeCached

public void removeCached(String name)

open

public FormattedTextMaker open(String name)

action

public void action(String fieldName,
                   Editor ed)

Description copied from class: Editor

This gets called by action(FieldTransfer ft,Editor ed) and by fieldChanged(FieldTransfer ft,Editor ed) if the field changed is a menu item. By default it will look for a method called void _action(Editor ed) and if it finds it, it will be executed.

Overrides:

action in class Editor

goBack

public void goBack()

Go to previous document/location. Acts as if the go back button had been pressed.

open

public void open()

Open a new file. Acts as if the open button had been pressed.

reload

public void reload()

Reload the current document. Acts as if the reload button had been pressed.

fieldChanged

public void fieldChanged(String fieldName,
                         Editor ed)

Description copied from class: Editor

This gets called by fieldChanged(FieldTransfer ft,Editor ed). By default it will look for a method called void _changed(Editor ed) and if it finds it, it will be executed.

Overrides:

fieldChanged in class Editor

update

public void update()

filesDropped

public void filesDropped(String[] fileName)

Description copied from class: Form

This is called when files are dropped on the Form and acceptsDroppedFiles is true.

Overrides:

filesDropped in class Form

Parameters:

fileName - the list of fileNames dropped.

setDisplayFont

public void setDisplayFont(Font f)

Set the display font.

openAndDisplay

public static HtmlViewer openAndDisplay(String url,
                                        int displayOptions,
                                        boolean execute)

main

public static void main(String[] args)