com.jgoodies.uifextras.fileaccess
Class DirectoryChooser

java.lang.Object
  extended by java.awt.Component
      extended by java.awt.Container
          extended by java.awt.Window
              extended by java.awt.Dialog
                  extended by javax.swing.JDialog
                      extended by com.jgoodies.uif.AbstractDialog
                          extended by com.jgoodies.uifextras.fileaccess.DirectoryChooser
All Implemented Interfaces:
ImageObserver, MenuContainer, Serializable, Accessible, RootPaneContainer, WindowConstants

public final class DirectoryChooser
extends com.jgoodies.uif.AbstractDialog

A dialog for choosing a directory. All access to the file system is delegated to an ExtFileSystemView.

Version:
$Revision: 1.11 $
Author:
Karsten Lentzsch
See Also:
ExtFileSystemView, Serialized Form

Nested Class Summary
 
Nested classes/interfaces inherited from class javax.swing.JDialog
JDialog.AccessibleJDialog
 
Nested classes/interfaces inherited from class java.awt.Dialog
Dialog.AccessibleAWTDialog, Dialog.ModalExclusionType, Dialog.ModalityType
 
Nested classes/interfaces inherited from class java.awt.Window
Window.AccessibleAWTWindow
 
Nested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainer
 
Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
Field Summary
 
Fields inherited from class com.jgoodies.uif.AbstractDialog
CARD_DIALOG_BORDER, DIALOG_BORDER, PROPERTYNAME_TRIGGER_CHANNEL
 
Fields inherited from class javax.swing.JDialog
accessibleContext, rootPane, rootPaneCheckingEnabled
 
Fields inherited from class java.awt.Dialog
DEFAULT_MODALITY_TYPE
 
Fields inherited from class java.awt.Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
Fields inherited from interface javax.swing.WindowConstants
DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE
 
Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
Method Summary
protected  JComponent buildContent()
          Builds and returns the dialog's content panel.
protected  JComponent buildHeader()
          Builds and returns the dialog's header panel.
static File chooseDirectory(Component parent)
          Lets the user choose a directory, which is then returned.
static File chooseDirectory(Component parent, boolean canSelectLeafDirectory)
          Lets the user choose and directory, which is then returned.
 void close()
          Closes the dialog.
 void doCancel()
          Cancels the choice and closes the dialog.
protected  void resizeHook(JComponent component)
          Uses the default Resizer to give the dialog an aesthetic aspect ratio.
 void setCanSelectLeafDirectory(boolean canSelectLeafDirectory)
          Enables or disables the selection of leaf directories.
 
Methods inherited from class com.jgoodies.uif.AbstractDialog
buffer, build, buildButtonBarWithClose, buildButtonBarWithOKCancel, buildButtonBarWithOKCancelApply, buildContentPane, configureWindowClosing, createAcceptButton, createApplyButton, createCancelButton, createCloseButton, createOKButton, createResetButton, doAccept, doApply, doClose, doCloseWindow, doReset, getApplyAction, getCancelAction, getCloseAction, getDialogBorder, getEscapeCancelsDefaultMode, getEscapeCancelsMode, getOKAction, getResetAction, getResourceMap, getString, getTriggerChannel, hasBeenCanceled, locateOnScreen, open, setDefaultButton, setEscapeCancelsDefaultMode, setEscapeCancelsMode, setInitialComponent, setResizable, setTriggerChannel, triggerCommit, triggerFlush
 
Methods inherited from class javax.swing.JDialog
addImpl, createRootPane, dialogInit, getAccessibleContext, getContentPane, getDefaultCloseOperation, getGlassPane, getGraphics, getJMenuBar, getLayeredPane, getRootPane, getTransferHandler, isDefaultLookAndFeelDecorated, isRootPaneCheckingEnabled, paramString, processWindowEvent, remove, repaint, setContentPane, setDefaultCloseOperation, setDefaultLookAndFeelDecorated, setGlassPane, setJMenuBar, setLayeredPane, setLayout, setRootPane, setRootPaneCheckingEnabled, setTransferHandler, update
 
Methods inherited from class java.awt.Dialog
addNotify, getModalityType, getTitle, hide, isModal, isResizable, isUndecorated, setModal, setModalityType, setResizable, setTitle, setUndecorated, setVisible, show, toBack
 
Methods inherited from class java.awt.Window
addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOwnedWindows, getOwner, getOwnerlessWindows, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isShowing, pack, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeNotify, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, toFront
 
Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusBackward, transferFocusDownCycle, validate, validateTree
 
Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resize, resize, setBackground, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusUpCycle
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Method Detail

chooseDirectory

public static File chooseDirectory(Component parent)
Lets the user choose a directory, which is then returned. Opens a directory chooser dialog using the owner frame. Offers only directories that are not a leaf.

Parameters:
parent - the optional owner of this dialog
Returns:
the chosen directory
See Also:
chooseDirectory(Component, boolean)

chooseDirectory

public static File chooseDirectory(Component parent,
                                   boolean canSelectLeafDirectory)
Lets the user choose and directory, which is then returned. Opens a directory chooser dialog using the owner frame and the given select-leaf-directory property.

Parameters:
parent - the optional owner of this dialog
canSelectLeafDirectory - true to be able to select directories that are a file system leaf, false to disallow to select such dirs
Returns:
the chosen directory
See Also:
chooseDirectory(Component)

buildHeader

protected JComponent buildHeader()
Builds and returns the dialog's header panel.

Overrides:
buildHeader in class com.jgoodies.uif.AbstractDialog

buildContent

protected JComponent buildContent()
Builds and returns the dialog's content panel.

Specified by:
buildContent in class com.jgoodies.uif.AbstractDialog

resizeHook

protected void resizeHook(JComponent component)
Uses the default Resizer to give the dialog an aesthetic aspect ratio.

Overrides:
resizeHook in class com.jgoodies.uif.AbstractDialog

close

public void close()
Closes the dialog.

Overrides:
close in class com.jgoodies.uif.AbstractDialog

doCancel

public void doCancel()
Cancels the choice and closes the dialog.

Overrides:
doCancel in class com.jgoodies.uif.AbstractDialog

setCanSelectLeafDirectory

public void setCanSelectLeafDirectory(boolean canSelectLeafDirectory)
Enables or disables the selection of leaf directories.

Parameters:
canSelectLeafDirectory - true to be able to select directories that are a file system leaf, false to disallow to select such dirs


Copyright © 2000-2008 JGoodies Karsten Lentzsch. All Rights Reserved.