ewe.filechooser
Class FileChooserBase

java.lang.Object
  ewe.ui.ControlBase
      ewe.ui.Control
          ewe.ui.Container
              ewe.ui.Canvas
                  ewe.ui.Panel
                      ewe.ui.CellPanel
                          ewe.ui.FormBase
                              ewe.ui.Form
                                  ewe.ui.Editor
                                      ewe.filechooser.FileChooserBase

All Implemented Interfaces:

CellConstants, ControlConstants, EventListener, FieldListener, HasProperties, ImageRefresher, IScroll, LayoutManager, ScrollClient, TimerProc, UIConstants

Direct Known Subclasses:

FileChooser

public class FileChooserBase

extends Editor

This class exists only as a container for some of the FileChooser static variables.

Field Summary

static int	ACCEPT_ANY This is an option for use in the constrcutor.
static String	allFilesMask This is the standard allFilesMask.
static boolean	allowFileViewing
static int	BROWSE This is an option for use in the constructor.
String	chosenDirectory Do not set this initially, it is only used when the user accepts a file.
Vector	chosenFiles Do not set this initially, it is only used when the user accepts a file.
static IImage	computer
static int	DESKTOP_VERSION This is an option for use in the constrcutor.
static boolean	desktopWide
static int	DIRECTORY_SELECT This is an option for use in the constructor.
static int	DIRECTORY_TREE This is an option for use in the constrcutor.
static int	DONT_SHOW_FILE_EXTENSION
static IImage	drive
static int	EMBEDDED This is an option for use in the constrcutor.
static int	EXPLORER_TYPE This is an option for use in the constrcutor.
static int	EXTRA_CONTROL This is an option for use in the constrcutor.
static int	FILE_MUST_EXIST This is an option for use in the constrcutor.
static IImage	folderUp
static Vector	globalLinks This is initially null.
static IImage	handHeld
static Vector	history This contains the directories or names of recently opened files.
static boolean	historyDirectoriesOnly This indicates that only directories should be placed in the history Vector.
static int	historySize This sets the number of history entries.
static int	INSTALL_SELECT This is an option for use in the constrcutor.
static FileChooserOptions	lastOptions
static int	LAUNCHER_TYPE This is an option for use in the constrcutor.
static int	MULTI_SELECT This is an option for use in the constrcutor.
static int	NO_CONFIRM_OVERWRITE This is an option for use in the constrcutor.
static int	NO_DIRECTORY_CHANGE This is an option for use in the constrcutor.
static int	NO_EXECUTE This is an option for use in the constrcutor.
static int	NO_WRITING This is an option for use in the constrcutor - the same as READ_ONLY.
static int	OPEN This is an option for use in the constructor.
static IImage	palm
static int	QUICK_SELECT This is an option for use in the constrcutor.
static int	READ_ONLY This is an option for use in the constrcutor - the same as NO_WRITING.
static int	SAVE This is an option for use in the constructor.
static ImageCache	toolButtons Do not set this directly.
static boolean	wideScreen

Fields inherited from class ewe.ui.Editor

coroutineStackSize, currentEvent, DoDataTransfer, fieldListeners, fieldsWillNotBeAdded, myObject, objectClass, sampleObject, transfers

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

FileChooserBase()

Methods inherited from class ewe.ui.Editor

action, action, addExternalField, addExternalField, addField, addField, addField, canExit, dataChanged, dataChanged, dismantle, enableScrolling, fieldChanged, fieldChanged, fieldEvent, findControlFor, findFields, findFieldTransfer, findFieldTransfer, findFieldTransfer, fireFieldChanged, fireFieldEvent, fireFieldEvent, formClosing, fromControls, fromControls, fromControls, fromControls, getData, getFileSaver, handleTransferError, main, make, modifyFields, onControlEvent, onDataChangeEvent, postEditorEvent, setData, setFields, setFileSaver, setObject, shown, toControls, toControls, toControls, toControls, transfer, transfer

Methods inherited from class ewe.ui.Form

_getSetField, addButton, addTabbedPanel, addToolbar, buttonsToMenu, buttonsToSoftKeyBar, buttonsToSoftKeyBar, cancelWait, checkButtons, close, closeAll, closeForTransfer, closeForTransfer, continueWait, createMenuItem, createMenuItem, createMenuItem, createWindow, defaultTitleTo, doButtons, doShowExec, exec, exec, exec, exec, exec, exec, exec, exec, exec, execute, execute, execute, exit, filesDropped, formShown, gatherButtons, getButton, getFirstFocus, getFormFrame, getProperties, getSoftKeyBarFor, getTopmostForm, handleAction, handleAction, hasExitButton, makeButtonForForm, makeButtonForForm, makeDefaultButton, makeDefaultButton, makeFrame, makeMenuItemForForm, makeMenuItemForForm, makeSoftKeys, makeSoftKeys, mb, menuItemSelected, modifyForSmartPhone, onEvent, onSoftKey, placeCancelOnLeft, removeSoftKeyBarFor, setOKCancel, setSoftKeyBarFor, setSoftKeyBarForAll, setTitle, setTopLevelTitle, setupFrame, show, show, show, show, show, show, 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

Methods inherited from interface ewe.ui.ScrollClient

getServer, setServer

Field Detail

folderUp

public static IImage folderUp

drive

public static IImage drive

computer

public static IImage computer

palm

public static IImage palm

handHeld

public static IImage handHeld

toolButtons

public static ImageCache toolButtons

Do not set this directly.

allowFileViewing

public static boolean allowFileViewing

globalLinks

public static Vector globalLinks

This is initially null. You can create a Vector for it and then add some FileChooserLink objects to it. These links will show up for all FileChooser boxes for this application.

chosenDirectory

public String chosenDirectory

Do not set this initially, it is only used when the user accepts a file. Then, this can be used along with the "chosenFiles" Vector for selecting multiple files.

chosenFiles

public Vector chosenFiles

Do not set this initially, it is only used when the user accepts a file. Then, this can be used along with the "chosenDirectory" field for selecting multiple files. It will contain a set of file names.

allFilesMask

public static String allFilesMask

This is the standard allFilesMask. By default it is "*.* - All Files.".

SAVE

public static final int SAVE

This is an option for use in the constructor. It is mutually exclusive with: OPEN, DIRECTORY_SELECT, BROWSE

See Also:

Constant Field Values

OPEN

public static final int OPEN

This is an option for use in the constructor. It is mutually exclusive with: SAVE, DIRECTORY_SELECT, BROWSE

See Also:

Constant Field Values

DIRECTORY_SELECT

public static final int DIRECTORY_SELECT

This is an option for use in the constructor. It is mutually exclusive with: SAVE, OPEN, BROWSE

See Also:

Constant Field Values

BROWSE

public static final int BROWSE

This is an option for use in the constructor. It is mutually exclusive with: SAVE, OPEN, DIRECTORY_SELECT

See Also:

Constant Field Values

QUICK_SELECT

public static final int QUICK_SELECT

This is an option for use in the constrcutor. It will cause a single click on a file to select the file and close the FileChooser.

See Also:

Constant Field Values

FILE_MUST_EXIST

public static final int FILE_MUST_EXIST

This is an option for use in the constrcutor. For opening, this indicates that the file must exist.

See Also:

Constant Field Values

DIRECTORY_TREE

public static final int DIRECTORY_TREE

This is an option for use in the constrcutor. This indicates that the directory tree should be displayed.

See Also:

Constant Field Values

NO_DIRECTORY_CHANGE

public static final int NO_DIRECTORY_CHANGE

This is an option for use in the constrcutor. This indicates that the FileChooser should not allow the directory to be changed.

See Also:

Constant Field Values

ACCEPT_ANY

public static final int ACCEPT_ANY

This is an option for use in the constrcutor. This indicates that the FileChooser will accept any file name given - even with wildcard characters ('*')

See Also:

Constant Field Values

NO_WRITING

public static final int NO_WRITING

This is an option for use in the constrcutor - the same as READ_ONLY. This disallows any kind of modification to the file system within the FileChooser.

See Also:

Constant Field Values

READ_ONLY

public static final int READ_ONLY

This is an option for use in the constrcutor - the same as NO_WRITING. This disallows any kind of modification to the file system within the FileChooser.

See Also:

Constant Field Values

INSTALL_SELECT

public static final int INSTALL_SELECT

This is an option for use in the constrcutor. This should be used with DIRECTORY_SELECT to indicate that you are selecting an install directory.

See Also:

Constant Field Values

DESKTOP_VERSION

public static final int DESKTOP_VERSION

This is an option for use in the constrcutor. This forces the use of the Desktop version of the FileChooser.

See Also:

Constant Field Values

NO_CONFIRM_OVERWRITE

public static final int NO_CONFIRM_OVERWRITE

This is an option for use in the constrcutor. This tells the system not to confirm overwritting of existing files when the SAVE option is used.

See Also:

Constant Field Values

EXTRA_CONTROL

public static final int EXTRA_CONTROL

This is an option for use in the constrcutor. This tells the FileChooser that you are going to be adding extra controls and so a Split panel should be used to place the extra control in.

See Also:

Constant Field Values

MULTI_SELECT

public static final int MULTI_SELECT

This is an option for use in the constrcutor. This allows the user to select multiple files.

See Also:

Constant Field Values

EXPLORER_TYPE

public static final int EXPLORER_TYPE

This is an option for use in the constrcutor. This uses an Explorer type display, with no file mask and no file choosing.

See Also:

Constant Field Values

LAUNCHER_TYPE

public static final int LAUNCHER_TYPE

This is an option for use in the constrcutor. This is no longer used.

See Also:

Constant Field Values

NO_EXECUTE

public static final int NO_EXECUTE

This is an option for use in the constrcutor. This indicates that program execution should not be allowed.

See Also:

Constant Field Values

EMBEDDED

public static final int EMBEDDED

This is an option for use in the constrcutor. This indicates that the file chooser will be embedded in another control and should not close when a file is chosen, but rather just fire an ControlEvent.ACTION event.

See Also:

Constant Field Values

DONT_SHOW_FILE_EXTENSION

public static final int DONT_SHOW_FILE_EXTENSION

See Also:

Constant Field Values

history

public static Vector history

This contains the directories or names of recently opened files.

historySize

public static int historySize

This sets the number of history entries. By default it is 10.

historyDirectoriesOnly

public static boolean historyDirectoriesOnly

This indicates that only directories should be placed in the history Vector. By default it is true.

wideScreen

public static boolean wideScreen

desktopWide

public static boolean desktopWide

lastOptions

public static FileChooserOptions lastOptions

Constructor Detail

FileChooserBase

public FileChooserBase()