courselog
Class OptionsForm

java.lang.Object
  extended by ewe.ui.ControlBase
      extended by ewe.ui.Control
          extended by ewe.ui.Container
              extended by ewe.ui.Canvas
                  extended by ewe.ui.Panel
                      extended by ewe.ui.CellPanel
                          extended by ewe.ui.FormBase
                              extended by ewe.ui.Form
                                  extended by courselog.CourseLogAppForm
                                      extended by courselog.OptionsForm
All Implemented Interfaces:
ewe.data.HasProperties, ewe.fx.ImageRefresher, ewe.sys.TimerProc, ewe.ui.CellConstants, ewe.ui.ControlConstants, ewe.ui.EventListener, ewe.ui.IScroll, ewe.ui.LayoutManager, ewe.ui.ScrollClient, ewe.ui.UIConstants

public class OptionsForm
extends CourseLogAppForm

Form to select the application options. Appart from the logging file name which must be selected by the user, this form allows to select to GPS port name and the minimum distance to log displacements.


Field Summary
protected  ActionKeySensitiveButton bLog
          Select logging file button.
protected  ActionKeySensitiveButton bMap
          Select Map dir button.
 ewe.io.SerialPortOptions dialogSPO
          Serial port options selected at the form level.
protected  ewe.ui.mInput inpMapDir
          Input area for the Maps directory name.
protected  ewe.ui.mInput inpTrackFile
          Input area for the logging file name.
 double minDistance
          Minimum distance selected in the options form.
 java.lang.String myLogFileName
          Log file name as stored in that dialog.
 java.lang.String myMapDir
          Maps directory name as stored in that dialog.
 int mySelectedUnits
          Units selected in the options form.
static double[] VDIST
          Vector of the proposed distances.
static int[] VUNITS
          Vector of the proposed units.
 
Fields inherited from class courselog.CourseLogAppForm
bLeft, bRight, dbgL, defC
 
Fields inherited from class ewe.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, deflt, dismantleOnClose, exitButtonDefined, exitSystemOnClose, exitValue, firstFocus, formFrame, globalIcon, handle, hasTopBar, keepFrame, moveable, no, noBorder, ok, pl, reset, resizable, resizeOnSIP, taskbarIcon, title, titleCancel, titleControls, titleOK, topControls, untitledTitle, windowFlagsToClear, windowFlagsToSet, windowIcon, windowTitle, yes
 
Fields inherited from class ewe.ui.FormBase
BACKB, CANCELB, close, cross, defaultShowOptions, 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, tools, YESB
 
Fields inherited from class ewe.ui.CellPanel
autoSpan, equalHeights, equalWidths, layout, mySplitter, nextSplitter, quickRecalculate
 
Fields inherited from class ewe.ui.Panel
all, backgroundImage, calculated, childListeners, defaultAddToMeCellConstraints, defaultTags, grid, lastAdded, layoutManager, made, noInsets, stretchFirstColumn, stretchFirstRow, stretchLastColumn, stretchLastRow, titleGap
 
Fields inherited from class ewe.ui.Canvas
isFullScrollClient, origin, scrollPercent, virtualSize
 
Fields inherited from class ewe.ui.Container
closedFocus, cycleFocus, dontAutoScroll, dontFocusOnChildren
 
Fields inherited from class ewe.ui.Control
_debug, backGround, beforeRemoved, borderColor, borderStyle, borderWidth, children, columns, constraints, DoPaintMethod, dragging, dragResolution, dragTime, exitKeys, fieldTransfer, font, foreGround, haveNativePaint, height, holdDownPause, holdTick, hotKey, image, lastSelected, listeners, maxHeight, maxWidth, menuState, minHeight, minWidth, modifiers, MyClass, name, next, np, parent, penStatus, popupSound, popupSoundClip, preferredHeight, preferredWidth, prev, prompt, promptControl, rows, ss, standardBorder, standardEdge, startDragResolution, tags, tail, text, toolTip, width, x, y
 
Fields inherited from class ewe.ui.ControlBase
clipItems, clipObject, clipOwner, curPoint, currentPenEvent, debugControl, debugFlag, DidHoldDown, doubleBuffer, doubleClickTime, firstPress, globalDrawFlat, globalEditable, globalEnabled, globalPalmStyle, globalSmallControls, GotPenDown, PenIsOn, pressPoint, TAG_LAST_USER_DATA, TAG_USER_DATA, TAKE_FIRST_PRESS, unnamed, useNativeTextInput
 
Fields inherited from interface ewe.ui.CellConstants
BORDER, BOTTOM, CELLFLAG, CELLMASK, CENTER, CONTROLMASK, DONTCHANGE, DONTFILL, DONTSTRETCH, EAST, FILL, FIXEDSIZE, GROW, HCENTER, HCONTRACT, HEXPAND, HFILL, HGROW, HSHRINK, HSTRETCH, INITIALLY_CLOSED, INITIALLY_MINIMIZED, INITIALLY_PREFERRED_SIZE, INSETS, LEFT, MAXIMUMSIZE, MINIMUMSIZE, NORTH, NORTHEAST, NORTHWEST, PREFERREDSIZE, RECT, RIGHT, SHRINK, SOUTH, SOUTHEAST, SOUTHWEST, SPAN, STRETCH, TEXTSIZE, TOP, VCENTER, VCONTRACT, VEXPAND, VFILL, VGROW, VSHRINK, VSTRETCH, WEST
 
Fields inherited from interface ewe.ui.IScroll
Higher, Horizontal, Lower, OPTION_INDICATOR_ONLY, PageHigher, PageLower, ScrollHigher, ScrollLower, TrackTo, Vertical
 
Fields inherited from interface ewe.ui.UIConstants
BDR_DOTTED, BDR_INNER, BDR_NOBORDER, BDR_OUTER, BDR_OUTLINE, BDR_RAISEDINNER, BDR_RAISEDOUTER, BDR_SUNKENINNER, BDR_SUNKENOUTER, 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 ewe.ui.ControlConstants
All, AlwaysEnabled, AlwaysRecalculateSizes, ByDeferredMouse, ByDeferredPen, ByFrameChange, ByKeyboard, ByMouse, ByPen, ByRequest, CalculatedSizes, Disabled, DisablePopupMenu, DisplayOnly, Down, DrawFlat, Flag, ForceResize, HasData, Invisible, KeepImage, KeepSIP, Left, MakeMenuAtLeastAsWide, Maximize, Minimize, MouseSensitive, NoFocus, NotAnEditor, NotEditable, PaintDataOnly, PaintOutsideOnly, PenTransparent, PreferredSizeOnly, Right, SendUpKeyEvents, SendUpPenEvents, ShowSIP, ShrinkToNothing, SmallControl, SpecialBackground, TakeControlEvents, TakesKeyFocus, Transparent, Up, WantDrag, WantHoldDown
 
Fields inherited from interface ewe.fx.ImageRefresher
KEEP_VISIBLE
 
Constructor Summary
OptionsForm(MainApplication app)
          Creates a new instance of OptionsForm.
 
Method Summary
 void executeAction(java.lang.String actString)
          Dispatch the action from a form button.
 double getDistanceFromCheck()
          Provides the minimum distance value according to the checked item.
 int getUnitFromCheck()
          Get the selected units set.
 void initFromApp()
          (Re-)Initialises the form from the application's values, discarding the current values.
 void onEvent(ewe.ui.Event ev)
          When a control is activated, reacts to control press.
 void openComPortOptions()
          Serial port dialog button was pressed, open the advanced dialog.
 void resetFromApp()
          Initialises the form from the application's default values, discarding the current values.
 void selectMapsDir()
          Called when the user whats to select the Maps directory.
 void selectTrackFile()
          Called when the user whats to select the track logging file.
 void setCheckFromDistance(double dist)
          Check the corresponding controls according to a given distance value.
 void setCheckFromUnits(int val)
          Check the corresponding controls according to a given units set.
 void tryExitForm(int nextState)
          Triggers an exit from the application
 void updateSerialOptions()
          Sets the port name label according to the current value of dialog SPO.
 void updateValues()
          Updates the application's settings from the current options values.
 
Methods inherited from class courselog.CourseLogAppForm
courseLogAppFormSetup
 
Methods inherited from class ewe.ui.Form
_getSetField, addButton, addTabbedPanel, addToolbar, buttonsToMenu, buttonsToSoftKeyBar, buttonsToSoftKeyBar, cancelWait, canExit, checkButtons, close, closeAll, closeForTransfer, closeForTransfer, continueWait, createMenuItem, createMenuItem, createMenuItem, createWindow, defaultTitleTo, dismantle, doButtons, doShowExec, exec, exec, exec, exec, exec, exec, exec, exec, exec, execute, execute, execute, exit, filesDropped, formClosing, formShown, gatherButtons, getButton, getFirstFocus, getFormFrame, getProperties, getSoftKeyBarFor, getTopmostForm, handleAction, handleAction, hasExitButton, make, makeButtonForForm, makeButtonForForm, makeDefaultButton, makeDefaultButton, makeFrame, makeMenuItemForForm, makeMenuItemForForm, makeSoftKeys, makeSoftKeys, mb, menuItemSelected, modifyForSmartPhone, onControlEvent, onDataChangeEvent, onSoftKey, onSoftKey, placeCancelOnLeft, removeSoftKeyBarFor, setOKCancel, setSoftKeyBarFor, setSoftKeyBarForAll, setTitle, setTopLevelTitle, setupFrame, show, show, show, show, show, show, shown, showWait, stopFormHandle, toolsOnBottom, waitUntilClosed, waitUntilClosed, waitUntilClosed, waitUntilClosed, waitUntilPainted
 
Methods inherited from class ewe.ui.CellPanel
calculateSizes, makeLayoutGrid, relayout, relayoutMe, removeAll, reShow, resize, resizeTo
 
Methods inherited from class ewe.ui.Panel
add, addChildListener, addDirectly, addLast, addLast, addNext, addNext, addNext, doBackground, doBorder, endRow, getControlTag, getPreferredSize, getSubControls, isEmpty, layout, remove, removeChildListener, sendToChildListeners, setText
 
Methods inherited from class ewe.ui.Canvas
canGo, canScreenScroll, checkScrolls, doScroll, fixOrigin, getActual, getBuffer, getCurrent, getDisplayedSize, getMySize, getPercent, getScrollablePanel, getScrollClient, getVisible, getVisibleArea, needScrollBar, onScroll, onSetOrigin, reduceClip, scroll, scroll, scrollToVisible, setOrigin, updateScrollServer
 
Methods inherited from class ewe.ui.Container
_paintChildren, add, containerHasFocus, dismantle, doHotKey, findChild, focusFirst, focusFirst, focusOnContainer, focusOnData, getChildren, getChildrenBackwards, getNextKeyFocus, gotFocus, lostFocus, repaintDataNow, takeFocus, takePromptControl
 
Methods inherited from class ewe.ui.Control
acceptsData, activate, addListener, addTimer, amOnTopFrame, calculateTextSize, cancelCut, cancelHoldDown, canEdit, chainDataChange, change, checkClipboardOperations, checkExitKey, checkMenu, checkMenuKey, checkModifiers, checkPenTransparent, clearTag, clipboardToString, clipboardTransfer, closeMenu, contains, contains, createGraphics, dataAccepted, dataBeingRemoved, dataDraggedOff, dataDraggedOver, dataDraggedOver, dataDroppedOn, dataTransferCancelled, deactivate, defaultTo, doAction, doActionKey, doMenu, dontAcceptDrop, doPaint, doPaintChildren, doPaintChildren, doPaintChildren, doPaintData, doPaintData, doShowMenu, dragged, exitEntry, fillBackground, fromClipboard, fromField, fromField, getAllDescendants, getAllSubControls, getBackground, getClipboardMenu, getClipObject, getControlBuffer, getControlBuffer, getDataRect, getDataToCopy, getDataToDragAndDrop, getDim, getDisplayText, getDragAndDropContext, getFont, getFontMetrics, getFontMetrics, getForeground, getFrame, getFrameOrContainer, getGraphics, getImage, getLastSelected, getLocation, getMaximumSize, getMenu, getMinimumSize, getModifiers, getNext, getParent, getPasswordCharacter, getPosInFrame, getPosInParent, getPreferredSize, getPrompt, getPromptText, getRect, getRect, getServer, getSize, getSizes, getTag, getText, getToolTip, getWindow, hasModifier, hasPopupFormAttached, hasTag, inheritModifiers, isChildOf, isModal, isOnMe, isSomeonesHotKey, makeFrameTopMost, makeHot, menuIsActive, modify, modifyAll, modifyAll, notifyAction, notifyDataChange, notifyDataChange, notNative_doPaintChildren, oldButWorksDoPaintChildren, oldPaintChildren, oldPostEvent, onKeyEvent, onLabelPenEvent, onPaint, onPenEvent, paintBackground, paintChildren, penClicked, penDoubleClicked, penHeld, penPressed, penReleased, penRightReleased, popupBeep, popupMenuClosed, popupMenuEvent, popupMenuEvent, postEvent, recalculatePreferredSize, redisplay, refresh, removeListener, removeTimer, repaint, repaintNow, repaintNow, repaintNow, requestPaint, requestResizeTo, resetRect, restore, scrollAndRepaint, sendToListeners, set, setBorder, setCell, setClipObject, setControl, setCursor, setFixedSize, setFont, setHotKey, setHotKey, setLocation, setMaximumSize, setMenu, setMinimumSize, setPreferredSize, setPromptControl, setRect, setRect, setServer, setTag, setTags, setTextSize, setToolTip, show, standardOnKeyEvent, startDragAndDrop, startDragAndDrop, startDragging, stopDragging, takeData, takeFromClipboard, testDim, ticked, toClipboard, toField, toField, toString, toTextData, transferPenPress, transferPenPress, tryDragAndDrop, tryNext, tryStartMenu, updateData, willAcceptDrop, willShowFrame
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface ewe.ui.ScrollClient
getServer, setServer
 

Field Detail

VDIST

public static final double[] VDIST
Vector of the proposed distances.


VUNITS

public static final int[] VUNITS
Vector of the proposed units.


inpTrackFile

protected ewe.ui.mInput inpTrackFile
Input area for the logging file name.


myLogFileName

public java.lang.String myLogFileName
Log file name as stored in that dialog.


bLog

protected ActionKeySensitiveButton bLog
Select logging file button.


inpMapDir

protected ewe.ui.mInput inpMapDir
Input area for the Maps directory name.


myMapDir

public java.lang.String myMapDir
Maps directory name as stored in that dialog.


bMap

protected ActionKeySensitiveButton bMap
Select Map dir button.


minDistance

public double minDistance
Minimum distance selected in the options form.


mySelectedUnits

public int mySelectedUnits
Units selected in the options form.


dialogSPO

public ewe.io.SerialPortOptions dialogSPO
Serial port options selected at the form level.

Constructor Detail

OptionsForm

public OptionsForm(MainApplication app)
Creates a new instance of OptionsForm. Initialises the form controls and the current values.

Parameters:
app - Application form to connect to this one.
Method Detail

executeAction

public void executeAction(java.lang.String actString)
Dispatch the action from a form button.

Parameters:
actString - String associated to the pressed button to determine the action.

tryExitForm

public void tryExitForm(int nextState)
Triggers an exit from the application

Parameters:
nextState - Index of the next state of the application. -1 means exit.

updateValues

public void updateValues()
Updates the application's settings from the current options values.


initFromApp

public void initFromApp()
(Re-)Initialises the form from the application's values, discarding the current values.


resetFromApp

public void resetFromApp()
Initialises the form from the application's default values, discarding the current values.


setCheckFromDistance

public void setCheckFromDistance(double dist)
Check the corresponding controls according to a given distance value.

Parameters:
dist - Minimum distance value, set to the accepted checkable values.

getDistanceFromCheck

public double getDistanceFromCheck()
Provides the minimum distance value according to the checked item.

Returns:
Checked distance.
See Also:
VDIST

setCheckFromUnits

public void setCheckFromUnits(int val)
Check the corresponding controls according to a given units set.

Parameters:
val - values as from Converters class.

getUnitFromCheck

public int getUnitFromCheck()
Get the selected units set.

Returns:
Value corresponding to Converters.FORMATxxx values.
See Also:
Converters

updateSerialOptions

public void updateSerialOptions()
Sets the port name label according to the current value of dialog SPO.


openComPortOptions

public void openComPortOptions()
Serial port dialog button was pressed, open the advanced dialog.


selectTrackFile

public void selectTrackFile()
Called when the user whats to select the track logging file. Opens a FileDialog at the location of the last track file. Track files are not overwritten, new trace points are appended at the end of the file.


selectMapsDir

public void selectMapsDir()
Called when the user whats to select the Maps directory. Opens a FileDialog at the location of the last Maps dir.


onEvent

public void onEvent(ewe.ui.Event ev)
When a control is activated, reacts to control press.

Specified by:
onEvent in interface ewe.ui.EventListener
Overrides:
onEvent in class ewe.ui.Form
Parameters:
ev - Control event.