eve.ui.game

Class MosaicPanel

java.lang.Object

eve.ui.ControlBase

eve.ui.Control

eve.ui.Container

eve.ui.Canvas

eve.ui.game.Mosaic

eve.ui.game.MosaicPanel

All Implemented Interfaces:

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

Direct Known Subclasses:

InteractivePanel

public class MosaicPanel
extends Mosaic

A MosaicPanel is an extension of a Mosaic which process pen/mouse events to trap conditions when the pen/mouse is pressed or dragged on images in the Mosaic.

Field Summary

Fields

Modifier and Type	Field and Description
boolean	autoScrolling
protected boolean	canRest
protected ImageDragContext	dragged
int	dragRate Use this to set the number of milliseconds in between drag messages.
int	hotCursor
protected boolean	inPanel
protected boolean	isActive
protected boolean	isDragging
protected boolean	isOn
protected boolean	isScrolling
protected Point	lastPoint
int	minDragRate Use this to set the number of milliseconds in between drag messages.
protected AniImage	movedOffOf This variable is valid during an imageMovedOn() call.
protected AniImage	movingOnTo This variable is valid during an imageMovedOff() call.
protected boolean	needDrag
protected AniImage	onImage
protected AniImage	pressedImage
protected int	restCount
protected AniImage	restedImage
protected boolean	resting
int	scrollStep
protected int	xScroll
protected int	yScroll

Fields inherited from class eve.ui.game.Mosaic

backgroundImage, firstSnap, images, pauseSnapShots, quickDragging

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.fx.ImageRefresher

KEEP_VISIBLE

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

ACTIVE, DISABLED, INACTIVE, INDENT_ITEM_FLAG, OUTLINED

Constructor Summary

Constructors

Constructor and Description
MosaicPanel()

Method Summary

Modifier and Type	Method and Description
void	activate() Allows mouse interaction with images on the
void	deactivate() This deactivates detecting mouse interaction with the images on the panel.
boolean	doMouseEnter(PenEvent ev, int x, int y)
boolean	doMouseExit(PenEvent ev, int x, int y)
boolean	doMouseMove(PenEvent ev, int x, int y)
void	dragged(DragContext mdc) This is called during the drag operation.
protected ImageDragContext	dragging(AniImage which) This should be called by mousePressed() or mouseDragged() to indicate to the panel that an image is being dragged.
protected void	dragging(ImageDragContext dc) This should be called by mousePressed() or mouseDragged() to indicate to the panel that an image is being dragged.
boolean	imageBeginDragged(AniImage which, Point pos) Indicates the pen/mouse is attempting to drag an image.
boolean	imageDragged(ImageDragContext drag, Point pos) Indicates the pen/mouse is dragging an image.
boolean	imageMovedOff(AniImage image) Indicates the pen/mouse is no longer over an image.
boolean	imageMovedOn(AniImage image) Indicates the pen/mouse is over an image without the pen/mouse being down (yet).
boolean	imageNotDragged(ImageDragContext drag, Point pos) Indicates the pen/mouse has released dragging an image.
boolean	imageNotRestingOn(AniImage which) Indicates the pen/mouse is no longer resting on an image.
boolean	imagePressed(AniImage which, Point pos) Indicates the pen/mouse is pressed on an image.
boolean	imageReleased(AniImage which, Point pos) Indicates the pen/mouse is released from an image.
boolean	imageRestingOn(AniImage which, int modifiers) Indicates the pen/mouse is resting on an image (after half second delay).
boolean	mouseEntered(PenEvent ev, Point pos) Indicates the mouse has entered the panel.
boolean	mouseExited(PenEvent ev, Point pos) Indicates the mouse has left the panel.
void	mouseHover(Point p, int modifiers, boolean isHover)
boolean	mouseMoved(PenEvent ev, Point pos) Indicates the mouse has left the panel.
void	onPenEvent(PenEvent ev)
void	penPressed(Point ev) Called when the Pen or Mouse button is pressed on the control.
void	penReleased(Point ev) Called when the Pen or Mouse button is released on the control.
void	setDragRate(int howLong)
void	setPressedImage(AniImage which)

Methods inherited from class eve.ui.game.Mosaic

addImage, addToSnapShot, confirmImage, doPaint, dropImage, onSetOrigin, paintMosaicBackground, paintMosaicBackground, refresh, refresh, refresh, refresh, refresh, refresh, refreshChanged, refreshOnScreen, removeFromSnapShot, removeImage, setAndSizeToBackgroundImage, setMovingImage, takeSnapShot

Methods inherited from class eve.ui.Canvas

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

Methods inherited from class eve.ui.Container

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

Methods inherited from class eve.ui.Control

acceptsData, addListener, amOnTopFrame, applyFontChange, baseOnPenEvent, bufferGraphics, bufferGraphics, bufferGraphics, bufferGraphics, bufferGraphics, cache, calculatedSizes, calculateSizes, 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, defaultTo, deferInWindowThread, doAction, doActionKey, doBackground, doMenu, dontAcceptDrop, doPaintChildren, doPaintData, doPaintData, doShowMenu, 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, 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, newEventThread, notifyAction, notifyDataChange, notifyDataChange, notifyMenuItemSelected, notifyStructureChanged, onControlEvent, onEvent, onKeyEvent, onLabelPenEvent, paintBackground, paintWithControlPainter, pauseEventThread, penClicked, penDoubleClicked, penHeld, penRightReleased, popupBeep, popupMenuClosed, popupMenuEvent, popupMenuEvent, postEvent, postInWindowThread, postUIEvent, putInside, queueKeyEvent, queuePenEvent, readLock, recalculatePreferredSize, redisplay, releaseBufferedGraphics, removed, removeListener, repaint, repaint, repaintInWindowThread, repaintInWindowThread, repaintNow, repaintNow, repaintNow, repaintNow, requestPaint, requestResizeTo, resetAllCachedProperties, resetCachedProperties, resetRect, resizeTo, 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, setText, 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.ScrollClient

getServer, setServer

Field Detail

hotCursor

public int hotCursor

isActive

protected boolean isActive

pressedImage

protected AniImage pressedImage

restedImage

protected AniImage restedImage

onImage

protected AniImage onImage

dragged

protected ImageDragContext dragged

isDragging

protected boolean isDragging

isScrolling

protected boolean isScrolling

needDrag

protected boolean needDrag

canRest

protected boolean canRest

resting

protected boolean resting

inPanel

protected boolean inPanel

isOn

protected boolean isOn

restCount

protected int restCount

xScroll

protected int xScroll

yScroll

protected int yScroll

scrollStep

public int scrollStep

autoScrolling

public boolean autoScrolling

minDragRate

public int minDragRate

Use this to set the number of milliseconds in between drag messages.

dragRate

public int dragRate

Use this to set the number of milliseconds in between drag messages.

movingOnTo

protected AniImage movingOnTo

This variable is valid during an imageMovedOff() call. It indicates the image that the pointer is moving on to. This may be null.

movedOffOf

protected AniImage movedOffOf

This variable is valid during an imageMovedOn() call. It indicates the image that the pointer moved off of before moving on to this. This may be null.

lastPoint

protected Point lastPoint

Constructor Detail

MosaicPanel

public MosaicPanel()

Method Detail

setPressedImage

public void setPressedImage(AniImage which)

dragging

protected final void dragging(ImageDragContext dc)

This should be called by mousePressed() or mouseDragged() to indicate to the panel that an image is being dragged.

dragging

protected final ImageDragContext dragging(AniImage which)

This should be called by mousePressed() or mouseDragged() to indicate to the panel that an image is being dragged.

setDragRate

public void setDragRate(int howLong)

deactivate

public final void deactivate()

This deactivates detecting mouse interaction with the images on the panel. It still allows mouseEntered(), mouseExited() etc. If the mouse is on any image it will call mouseMovedOff() etc.

Overrides:

deactivate in class Control

activate

public final void activate()

Allows mouse interaction with images on the

Overrides:

activate in class Control

doMouseExit

public final boolean doMouseExit(PenEvent ev,
                                 int x,
                                 int y)

doMouseEnter

public final boolean doMouseEnter(PenEvent ev,
                                  int x,
                                  int y)

doMouseMove

public final boolean doMouseMove(PenEvent ev,
                                 int x,
                                 int y)

onPenEvent

public void onPenEvent(PenEvent ev)

Overrides:

onPenEvent in class Control

penPressed

public final void penPressed(Point ev)

Description copied from class: Control

Called when the Pen or Mouse button is pressed on the control. This is called by the onPenEvent(PenEvent ev) method.

Within this method you can use the Control.Gui.currentPenPress() value to find out more about the PenEvent that caused this - including any modifiers (e.g. SHIFT keys) or determine if the left or right mouse button was pressed.

Overrides:

penPressed in class Control

Parameters:

ev - The point on the Control where the pen was pressed.

dragged

public final void dragged(DragContext mdc)

Description copied from class: Control

This is called during the drag operation. It is also called by default by the startDragging() method if you do not override it.

Overrides:

dragged in class Control

Parameters:

mdc - The DragContext for the dragging operation.

penReleased

public final void penReleased(Point ev)

Description copied from class: Control

Called when the Pen or Mouse button is released on the control. This is called by the onPenEvent(PenEvent ev) method.

Within this method you can use the Control.Gui.currentPenPress() value to find out more about the PenEvent that caused this - including any modifiers (e.g. SHIFT keys) or determine if the left or right mouse button was pressed.

Overrides:

penReleased in class Control

Parameters:

ev - The point on the Control where the pen was released.

mouseEntered

public boolean mouseEntered(PenEvent ev,
                            Point pos)

Indicates the mouse has entered the panel.

mouseExited

public boolean mouseExited(PenEvent ev,
                           Point pos)

Indicates the mouse has left the panel.

mouseMoved

public boolean mouseMoved(PenEvent ev,
                          Point pos)

Indicates the mouse has left the panel.

imagePressed

public boolean imagePressed(AniImage which,
                            Point pos)

Indicates the pen/mouse is pressed on an image.

imageReleased

public boolean imageReleased(AniImage which,
                             Point pos)

Indicates the pen/mouse is released from an image.

imageBeginDragged

public boolean imageBeginDragged(AniImage which,
                                 Point pos)

Indicates the pen/mouse is attempting to drag an image. If you wish to drag the image return true. You can call the dragging() method to change the default ImageDragContext.

imageDragged

public boolean imageDragged(ImageDragContext drag,
                            Point pos)

Indicates the pen/mouse is dragging an image. Will only be called if imageBeingDragged returned true.

imageNotDragged

public boolean imageNotDragged(ImageDragContext drag,
                               Point pos)

Indicates the pen/mouse has released dragging an image.

imageMovedOn

public boolean imageMovedOn(AniImage image)

Indicates the pen/mouse is over an image without the pen/mouse being down (yet).

imageMovedOff

public boolean imageMovedOff(AniImage image)

Indicates the pen/mouse is no longer over an image.

imageRestingOn

public boolean imageRestingOn(AniImage which,
                              int modifiers)

Indicates the pen/mouse is resting on an image (after half second delay).

imageNotRestingOn

public boolean imageNotRestingOn(AniImage which)

Indicates the pen/mouse is no longer resting on an image.

mouseHover

public void mouseHover(Point p,
                       int modifiers,
                       boolean isHover)

Overrides:

mouseHover in class Control