oracle.ide.net
Class URLTextField

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.text.JTextComponent
                  javax.swing.JTextField
                      oracle.javatools.controls.completionfield.CompletionTextField
                          oracle.javatools.controls.FileField
                              oracle.ide.net.URLTextField

All Implemented Interfaces:

javax.accessibility.Accessible, java.awt.event.ActionListener, java.util.EventListener, java.awt.image.ImageObserver, java.awt.MenuContainer, javax.swing.Scrollable, java.io.Serializable, javax.swing.SwingConstants

public class URLTextField

extends FileField

implements java.awt.event.ActionListener

This is a subclass of JTextField that is intended to hold a single URL. The user is allowed to type freely into the text field, and the text will be converted into an URL when the getURL() method is called; if the string cannot be converted into an URL for whatever reason, getURL() returns null.

As a convenience, URLTextField also implements ActionListener. This is intended to be used by "Browse..." buttons whose action is to bring up the URLChooser to select an appropriate file/directory. Such a button just needs to set the URLTextField instance as its ActionListener.

See Also:

Serialized Form

Nested Class Summary

Nested classes inherited from class javax.swing.JTextField

javax.swing.JTextField.AccessibleJTextField

Nested classes inherited from class javax.swing.text.JTextComponent

javax.swing.text.JTextComponent.AccessibleJTextComponent, javax.swing.text.JTextComponent.KeyBinding

Nested classes inherited from class javax.swing.JComponent

javax.swing.JComponent.AccessibleJComponent

Nested classes inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Nested classes inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

static int	OPEN_DIALOG Dialog type constant indicating that the URL chooser invoked through this field should be an open dialog.
static int	SAVE_DIALOG Dialog type constant indicating that the URL chooser invoked through this field should be a save dialog.

Fields inherited from class oracle.javatools.controls.completionfield.CompletionTextField

SHOW_INSIGHT_ACTION_NAME

Fields inherited from class javax.swing.JTextField

notifyAction

Fields inherited from class javax.swing.text.JTextComponent

DEFAULT_KEYMAP, FOCUS_ACCELERATOR_KEY

Fields inherited from class javax.swing.JComponent

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface javax.swing.SwingConstants

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

URLTextField()
Creates an empty URLTextField that is configured to handle a directory URL.

URLTextField(java.net.URL url)
Creates a new URLTextField whose displayed value reflects the specified URL, which is interpreted as representing a directory.

URLTextField(java.net.URL url, boolean isDir)

URLTextField(java.net.URL url, boolean isDir, boolean showJarsAsDirs)

Method Summary

void	actionPerformed(java.awt.event.ActionEvent e) Convenience implementation for allowing buttons to set the URLTextField as their ActionListener.
boolean	browseForURL() Pops up a URLChooser that allows the user to browse for the URL.
protected URLChooser	createChooser(java.net.URL url) Creates a URL chooser initialized to the URL displayed in this field.
URLChooserInit	getChooserInit() Retrieves the current filter for browsing new URLs
int	getDialogType() Gets whether the URL chooser displayed through this text field is an Open dialog or a Save dialog.
URLFilter	getFilter() Retrieves the current filter for browsing new URLs
java.net.URL	getURL() Returns an URL corresponding to the text that is currently displayed in the text field.
boolean	isDirectoryOnly() Whether the URLTextField is displaying a directory or a file.
static URLTextField	newForSavingFile() Convenience method for a common configuration of URLTextField.
void	setBaseURL(java.net.URL baseURL) This is an undocumented feature.
void	setChooserInit(URLChooserInit chooserInit) Specifies a URLChooserInit to use when browsing for new URLs.
void	setClearAllFilters(boolean clearFilters)
void	setDefaultChooserURL(java.net.URL url)
void	setDialogHelpContext(java.lang.String helpContext)
void	setDialogTitle(java.lang.String title) Sets the title to use for the browse dialog
void	setDialogType(int type) Sets whether the URL chooser displayed through this text field is an Open dialog or a Save dialog.
void	setDirectoryOnly(boolean isDir) Specifies whether this URLTextField should display directories or files.
void	setFilter(URLFilter filter) Specifies a filter to use when browsing for new URLs.
void	setURL(java.net.URL url) Sets the URL displayed in the URLTextField.

Methods inherited from class oracle.javatools.controls.FileField

setOnlyDirectories

Methods inherited from class oracle.javatools.controls.completionfield.CompletionTextField

getCompletionBackground, isAlignWithField, isInsightActive, isInsightVisible, isWidthOfField, registerInsightProvider, removeNotify, setAlignWithField, setCompletionBackground, setInsightVisible, setText, setWidthOfField, unregisterInsightProvider

Methods inherited from class javax.swing.JTextField

addActionListener, configurePropertiesFromAction, createActionPropertyChangeListener, createDefaultModel, fireActionPerformed, getAccessibleContext, getAction, getActionListeners, getActions, getColumns, getColumnWidth, getHorizontalAlignment, getHorizontalVisibility, getPreferredSize, getScrollOffset, getUIClassID, isValidateRoot, paramString, postActionEvent, removeActionListener, scrollRectToVisible, setAction, setActionCommand, setColumns, setDocument, setFont, setHorizontalAlignment, setScrollOffset

Methods inherited from class javax.swing.text.JTextComponent

addCaretListener, addInputMethodListener, addKeymap, copy, cut, fireCaretUpdate, getCaret, getCaretColor, getCaretListeners, getCaretPosition, getDisabledTextColor, getDocument, getDragEnabled, getFocusAccelerator, getHighlighter, getInputMethodRequests, getKeymap, getKeymap, getMargin, getNavigationFilter, getPreferredScrollableViewportSize, getScrollableBlockIncrement, getScrollableTracksViewportHeight, getScrollableTracksViewportWidth, getScrollableUnitIncrement, getSelectedText, getSelectedTextColor, getSelectionColor, getSelectionEnd, getSelectionStart, getText, getText, getToolTipText, getUI, isEditable, loadKeymap, modelToView, moveCaretPosition, paste, processInputMethodEvent, read, removeCaretListener, removeKeymap, replaceSelection, select, selectAll, setCaret, setCaretColor, setCaretPosition, setComponentOrientation, setDisabledTextColor, setDragEnabled, setEditable, setFocusAccelerator, setHighlighter, setKeymap, setMargin, setNavigationFilter, setSelectedTextColor, setSelectionColor, setSelectionEnd, setSelectionStart, setUI, updateUI, viewToModel, write

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPropertyChangeListeners, getPropertyChangeListeners, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setForeground, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setLayout, transferFocusBackward, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processMouseEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

OPEN_DIALOG

public static final int OPEN_DIALOG

Dialog type constant indicating that the URL chooser invoked through this field should be an open dialog.

See Also:

Constant Field Values

SAVE_DIALOG

public static final int SAVE_DIALOG

Dialog type constant indicating that the URL chooser invoked through this field should be a save dialog.

See Also:

Constant Field Values

Constructor Detail

URLTextField

public URLTextField()

Creates an empty URLTextField that is configured to handle a directory URL.

URLTextField

public URLTextField(java.net.URL url)

Creates a new URLTextField whose displayed value reflects the specified URL, which is interpreted as representing a directory. If the URL is null, then the text field will be initially empty. If the URL that the text field displays is for a file, you must use the URLTextField(URL, boolean) constructor instead.

URLTextField

public URLTextField(java.net.URL url,
                    boolean isDir)

Parameters:

url - The initial URL to show in the text field. This may be null, which means the text field will be initially empty.

isDir - If true the URL returned by the getURL() method will be an URL for a directory; otherwise, it will be an URL for a file.

URLTextField

public URLTextField(java.net.URL url,
                    boolean isDir,
                    boolean showJarsAsDirs)

Parameters:

url - The initial URL to show in the text field. This may be null, which means the text field will be initially empty.

isDir - If true the URL returned by the getURL() method will be an URL for a directory; otherwise, it will be an URL for a file.

showJarsAsDirs - If true the dialog will show jar files in the directory list.

Method Detail

newForSavingFile

public static URLTextField newForSavingFile()

Convenience method for a common configuration of URLTextField. This returns a URLTextField that is used to prompt the user for an output (save) URL. It is equivalent to calling new URLTextField( null, false, false );

getURL

public java.net.URL getURL()

Returns an URL corresponding to the text that is currently displayed in the text field.

setURL

public void setURL(java.net.URL url)

Sets the URL displayed in the URLTextField.

isDirectoryOnly

public boolean isDirectoryOnly()

Whether the URLTextField is displaying a directory or a file.

Returns:

true if the URL displayed by this field should be a directory.

setDirectoryOnly

public void setDirectoryOnly(boolean isDir)

Specifies whether this URLTextField should display directories or files.

Parameters:

isDir - whether the URL displayed by this URLTextField should be a directory.

setClearAllFilters

public void setClearAllFilters(boolean clearFilters)

setDefaultChooserURL

public void setDefaultChooserURL(java.net.URL url)

getFilter

public URLFilter getFilter()

Retrieves the current filter for browsing new URLs

Returns:

the current filter

setFilter

public void setFilter(URLFilter filter)

Specifies a filter to use when browsing for new URLs.

Parameters:

filter - the filter to use

setDialogType

public void setDialogType(int type)

Sets whether the URL chooser displayed through this text field is an Open dialog or a Save dialog.

getDialogType

public int getDialogType()

Gets whether the URL chooser displayed through this text field is an Open dialog or a Save dialog.

getChooserInit

public URLChooserInit getChooserInit()

Retrieves the current filter for browsing new URLs

Returns:

the current filter

setChooserInit

public void setChooserInit(URLChooserInit chooserInit)

Specifies a URLChooserInit to use when browsing for new URLs.

Parameters:

chooserInit - the URLChooserInit to use

setBaseURL

public void setBaseURL(java.net.URL baseURL)

This is an undocumented feature.

setDialogTitle

public void setDialogTitle(java.lang.String title)

Sets the title to use for the browse dialog

setDialogHelpContext

public void setDialogHelpContext(java.lang.String helpContext)

actionPerformed

public void actionPerformed(java.awt.event.ActionEvent e)

Convenience implementation for allowing buttons to set the URLTextField as their ActionListener. When the action event is triggered, the user will be prompted to browse for a directory using the URLChooser.

Specified by:

actionPerformed in interface java.awt.event.ActionListener

browseForURL

public boolean browseForURL()

Pops up a URLChooser that allows the user to browse for the URL. The URLChooser will come up in either FILES_ONLY mode or in DIRECTORIES_ONLY mode depending on the isDir flag that was passed into the URLTextField constructor.

createChooser

protected URLChooser createChooser(java.net.URL url)

Creates a URL chooser initialized to the URL displayed in this field.

Parameters:

url - The initial URL to select in the chooser.