eve.ui

Class ScrollablePanel

java.lang.Object

eve.ui.ControlBase

eve.ui.Control

eve.ui.Container

eve.ui.Canvas

eve.ui.Panel

eve.ui.CellPanel

eve.ui.ScrollablePanel

All Implemented Interfaces:

Drawable, ImageRefresher, DataInterface, TimerProc, CellConstants, ControlConstants, HasAncestor, IScroll, LayoutManager, ScrollClient, ScrollServer, UIConstants, EventListener

Direct Known Subclasses:

ScrollBarPanel, UpDownScroller

public abstract class ScrollablePanel
extends CellPanel
implements ScrollServer

This is a CellPanel which is used as the base for ScrollServer implementations.

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	alwaysShow
static int	AlwaysShowHorizontalScrollers This is an option for setOptions() - it keeps horizontal scrollers always displayed.
static int	AlwaysShowVerticalScrollers This is an option for setOptions() - it keeps vertical scrollers always displayed.
protected static boolean	blockUpdate
ScrollClient	client The client which the panel contains.
protected boolean	hscrollerChanges This is true so long as neither AlwaysShowHorizontalScrollers nor NeverShowHorizontalScrollers are selected as options.
protected boolean	neverShow
static int	NeverShowHorizontalScrollers This is an option for setOptions() - it prevents horizontal scrollers from being displayed.
static int	NeverShowVerticalScrollers This is an option for setOptions() - it prevents vertical scrollers from being displayed.
protected int	options
static int	Permanent This is an option for setOptions() - it keeps both horizontal and vertical scrollers permanently displayed.
static int	vanish
protected boolean	vscrollerChanges This is true so long as neither AlwaysShowVerticalScrollers nor NeverShowVerticalScrollers are selected as options.

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.IScroll

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

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.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
ScrollablePanel(ScrollClient client)

Method Summary

Modifier and Type	Method and Description
void	changeContents(Control what) Only use this if the ScrollabePanel contains a ScrollableHolder.
void	checkScrolls() This method tells the ScrollServer to check the state of the ScrollClient to determine if it needs to update its on-screen scroll controls.
abstract void	checkScrolls(int width, int height, boolean redraw)
void	dismantle(Control downTo)
ScrollClient	getClient() This returns the ScrollClient of the ScrollServer.
int	getClientConstraints() This returns the clientConstraints, which will be any of the HEXPAND, HCONTRACT, VEXPAND, VCONTRACT values ORed together.
void	make(boolean remake) This is used to "make" the control before being displayed.
abstract void	modifyScrollers(int set, int clear)
void	redisplay() Do not use this to repaint a control - use repaintNow() instead.
void	reset() This will reset the origin of a client (if it is a ScrollableHolder) to (0,0) if it is not already so.
void	resizeTo(int w, int h) This is called to change the width and height values.
void	setClientConstraints(boolean hExpand, boolean hContract, boolean vExpand, boolean vContract) Set the clientConstraints value specifying the behavior horizontally and vertically.
void	setClientConstraints(int constraints) Set the clientConstraints value specifying the behavior horizontally and vertically.
void	setOptions(int options) Set options for the ScrollablePanel.

Methods inherited from class eve.ui.CellPanel

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

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, 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, formClosing, 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, onControlEvent, onKeyEvent, onLabelPenEvent, onPenEvent, paintBackground, paintWithControlPainter, pauseEventThread, penClicked, penDoubleClicked, penHeld, penPressed, penReleased, penRightReleased, popupBeep, popupMenuClosed, popupMenuEvent, popupMenuEvent, postEvent, postInWindowThread, postUIEvent, putInside, queueKeyEvent, queuePenEvent, readLock, recalculatePreferredSize, 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, shown, 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.ScrollServer

updateScroll

Methods inherited from interface eve.ui.ScrollClient

getServer, setServer

Field Detail

client

public ScrollClient client

The client which the panel contains.

Permanent

public static int Permanent

This is an option for setOptions() - it keeps both horizontal and vertical scrollers permanently displayed.

AlwaysShowHorizontalScrollers

public static int AlwaysShowHorizontalScrollers

This is an option for setOptions() - it keeps horizontal scrollers always displayed.

AlwaysShowVerticalScrollers

public static int AlwaysShowVerticalScrollers

This is an option for setOptions() - it keeps vertical scrollers always displayed.

NeverShowHorizontalScrollers

public static int NeverShowHorizontalScrollers

This is an option for setOptions() - it prevents horizontal scrollers from being displayed.

NeverShowVerticalScrollers

public static int NeverShowVerticalScrollers

This is an option for setOptions() - it prevents vertical scrollers from being displayed.

options

protected int options

hscrollerChanges

protected boolean hscrollerChanges

This is true so long as neither AlwaysShowHorizontalScrollers nor NeverShowHorizontalScrollers are selected as options.

vscrollerChanges

protected boolean vscrollerChanges

This is true so long as neither AlwaysShowVerticalScrollers nor NeverShowVerticalScrollers are selected as options.

alwaysShow

protected boolean alwaysShow

neverShow

protected boolean neverShow

vanish

public static int vanish

blockUpdate

protected static boolean blockUpdate

Constructor Detail

ScrollablePanel

public ScrollablePanel(ScrollClient client)

Method Detail

getClient

public ScrollClient getClient()

Description copied from interface: ScrollServer

This returns the ScrollClient of the ScrollServer.

Specified by:

getClient in interface ScrollServer

getClientConstraints

public int getClientConstraints()

This returns the clientConstraints, which will be any of the HEXPAND, HCONTRACT, VEXPAND, VCONTRACT values ORed together. By default it is HEXPAND|VEXPAND meaning the client will be expanded bigger than its preferred size, but will not be contracted smaller than its preferred size.

setClientConstraints

public void setClientConstraints(boolean hExpand,
                                 boolean hContract,
                                 boolean vExpand,
                                 boolean vContract)

Set the clientConstraints value specifying the behavior horizontally and vertically.

Parameters:

hExpand - if this is true then the client control will be expanded horizontally.

hContract - if this is true then the client control will be contracted horizontally.

vExpand - if this is true then the client control will be expanded vertically.

vContract - if this is true then the client control will be contracted vertically.

setClientConstraints

public void setClientConstraints(int constraints)

Set the clientConstraints value specifying the behavior horizontally and vertically.

Parameters:

constraints - any of the HEXPAND, HCONTRACT, VEXPAND, VCONTRACT values ORed together.

changeContents

public void changeContents(Control what)

Only use this if the ScrollabePanel contains a ScrollableHolder. This will change the contents of the ScrollableHolder.

setOptions

public void setOptions(int options)

Set options for the ScrollablePanel. Call this after creating the ScrollBar, but only call it once.

resizeTo

public void resizeTo(int w,
                     int h)

Description copied from class: Control

This is called to change the width and height values. It is always called when the Control gets resized so you can override it to react to a resizing of a Control.

Overrides:

resizeTo in class CellPanel

checkScrolls

public abstract void checkScrolls(int width,
                                  int height,
                                  boolean redraw)

checkScrolls

public void checkScrolls()

Description copied from interface: ScrollServer

This method tells the ScrollServer to check the state of the ScrollClient to determine if it needs to update its on-screen scroll controls.

Specified by:

checkScrolls in interface ScrollServer

Overrides:

checkScrolls in class Canvas

make

public void make(boolean remake)

Description copied from class: Container

This is used to "make" the control before being displayed.

Overrides:

make in class CellPanel

Parameters:

remake - if this is true then you should do a full re-make.

redisplay

public void redisplay()

Description copied from class: Control

Do not use this to repaint a control - use repaintNow() instead. This is used to cause a control to re-layout its components and re-calculate its preferred size.

Overrides:

redisplay in class Control

reset

public void reset()

This will reset the origin of a client (if it is a ScrollableHolder) to (0,0) if it is not already so. If it is already so, it has no effect.

modifyScrollers

public abstract void modifyScrollers(int set,
                                     int clear)

dismantle

public void dismantle(Control downTo)

Overrides:

dismantle in class Container