©
本文档使用 PHP中文网手册 发布
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object java.awt.Component java.awt.Container javax.swing.JComponent javax.swing.JFileChooser
public class JFileChooser
JFileChooser
为用户选择文件提供了一种简单的机制。有关使用 JFileChooser
的更多信息,请参阅 The Java Tutorial 中的 How to Use File Choosers 一节。
以下代码弹出一个针对用户主目录的文件选择器,其中只显示 .jpg 和 .gif 图像:
JFileChooser chooser = new JFileChooser(); FileNameExtensionFilter filter = new FileNameExtensionFilter( "JPG & GIF Images", "jpg", "gif"); chooser.setFileFilter(filter); int returnVal = chooser.showOpenDialog(parent); if(returnVal == JFileChooser.APPROVE_OPTION) { System.out.println("You chose to open this file: " + chooser.getSelectedFile().getName()); }
警告:Swing 不是线程安全的。有关更多信息,请参阅 Swing's Threading Policy。
嵌套类摘要 | |
---|---|
protected class |
JFileChooser.AccessibleJFileChooser
此类实现对 JFileChooser 类的可访问性支持。 |
从类 javax.swing.JComponent 继承的嵌套类/接口 |
---|
JComponent.AccessibleJComponent |
从类 java.awt.Container 继承的嵌套类/接口 |
---|
Container.AccessibleAWTContainer |
从类 java.awt.Component 继承的嵌套类/接口 |
---|
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy |
字段摘要 | |
---|---|
static String |
ACCEPT_ALL_FILE_FILTER_USED_CHANGED_PROPERTY
标识是否使用 AcceptAllFileFilter。 |
protected AccessibleContext |
accessibleContext
|
static String |
ACCESSORY_CHANGED_PROPERTY
声明正在使用不同的 accessory 组件(例如预览文件)。 |
static String |
APPROVE_BUTTON_MNEMONIC_CHANGED_PROPERTY
标识用于确认(yes、ok)按钮的助记符的更改。 |
static String |
APPROVE_BUTTON_TEXT_CHANGED_PROPERTY
标识确认(yes、ok)按钮上的文本更改。 |
static String |
APPROVE_BUTTON_TOOL_TIP_TEXT_CHANGED_PROPERTY
标识用于确认(yes、ok)按钮的工具提示文本的更改。 |
static int |
APPROVE_OPTION
选择确认(yes、ok)后返回该值。 |
static String |
APPROVE_SELECTION
指示确认当前的选择(与按下 yes 或 ok 相同)。 |
static int |
CANCEL_OPTION
选择 cancel 后的返回该值。 |
static String |
CANCEL_SELECTION
指示取消当前的选择。 |
static String |
CHOOSABLE_FILE_FILTER_CHANGED_PROPERTY
标识预定义文件过滤器列表的更改,用户可从该列表中进行选择。 |
static String |
CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY
指示显示控制按钮。 |
static int |
CUSTOM_DIALOG
指示 JFileChooser 支持特定于开发人员文件操作的类型值。 |
static String |
DIALOG_TITLE_CHANGED_PROPERTY
标识对话框标题的更改。 |
static String |
DIALOG_TYPE_CHANGED_PROPERTY
标识显示文件类型的更改(仅显示文件、仅显示目录或显示文件和目录)。 |
static int |
DIRECTORIES_ONLY
指示仅显示目录。 |
static String |
DIRECTORY_CHANGED_PROPERTY
标识用户的目录更改。 |
static int |
ERROR_OPTION
发生错误后返回该值。 |
static String |
FILE_FILTER_CHANGED_PROPERTY
用户更改要显示的文件种类。 |
static String |
FILE_HIDING_CHANGED_PROPERTY
标识在显示隐藏文件属性中的更改。 |
static String |
FILE_SELECTION_MODE_CHANGED_PROPERTY
标识在选择种类(选择单个、多个等等)方面的更改。 |
static String |
FILE_SYSTEM_VIEW_CHANGED_PROPERTY
声明使用其他对象在系统上查找可用的驱动器。 |
static String |
FILE_VIEW_CHANGED_PROPERTY
声明使用其他对象检索文件信息。 |
static int |
FILES_AND_DIRECTORIES
指示显示文件和目录。 |
static int |
FILES_ONLY
指示仅显示文件。 |
static String |
MULTI_SELECTION_ENABLED_CHANGED_PROPERTY
允许选择多个文件。 |
static int |
OPEN_DIALOG
指示 JFileChooser 支持 "Open" 文件操作的类型值。 |
static int |
SAVE_DIALOG
指示 JFileChooser 支持 "Save" 文件操作的类型值。 |
static String |
SELECTED_FILE_CHANGED_PROPERTY
标识用户单个文件选择的更改。 |
static String |
SELECTED_FILES_CHANGED_PROPERTY
标识用户多个文件选择的更改。 |
从类 javax.swing.JComponent 继承的字段 |
---|
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW |
从类 java.awt.Component 继承的字段 |
---|
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT |
从接口 java.awt.image.ImageObserver 继承的字段 |
---|
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH |
构造方法摘要 | |
---|---|
JFileChooser()
构造一个指向用户默认目录的 JFileChooser 。 |
|
JFileChooser(File currentDirectory)
使用给定的 File 作为路径来构造一个 JFileChooser 。 |
|
JFileChooser(File currentDirectory,
FileSystemView fsv)
使用给定的当前目录和 FileSystemView 构造一个 JFileChooser 。 |
|
JFileChooser(FileSystemView fsv)
使用给定的 FileSystemView 构造一个 JFileChooser 。 |
|
JFileChooser(String currentDirectoryPath)
构造一个使用给定路径的 JFileChooser 。 |
|
JFileChooser(String currentDirectoryPath,
FileSystemView fsv)
使用给定的当前目录路径和 FileSystemView 构造一个 JFileChooser 。 |
方法摘要 | |
---|---|
boolean |
accept(File f)
如果应该显示该文件,则返回 true。 |
void |
addActionListener(ActionListener l)
向文件选择器添加一个 ActionListener 。 |
void |
addChoosableFileFilter(FileFilter filter)
向用户可选择的文件过滤器列表添加一个过滤器。 |
void |
approveSelection()
用户单击 Approve 按钮(默认情况下标有 "Open" 或 "Save")时由 UI 调用此方法。 |
void |
cancelSelection()
用户选择 Cancel 按钮时由 UI 调用此方法。 |
void |
changeToParentDirectory()
将要设置的目录更改为当前目录的父级。 |
protected JDialog |
createDialog(Component parent)
创建并返回包含 this 的新 JDialog ,在 parent 窗体中的 parent 上居中。 |
void |
ensureFileIsVisible(File f)
确保指定的文件是可见的,不是隐藏的。 |
protected void |
fireActionPerformed(String command)
通知对此事件类型感兴趣的所有侦听器。 |
FileFilter |
getAcceptAllFileFilter()
返回 AcceptAll 文件过滤器。 |
AccessibleContext |
getAccessibleContext()
获取与此 JFileChooser 关联的 AccessibleContext。 |
JComponent |
getAccessory()
返回 accessory 组件。 |
ActionListener[] |
getActionListeners()
返回在此文件选择器上注册的所有操作侦听器的数组。 |
int |
getApproveButtonMnemonic()
返回确认按钮的助记符。 |
String |
getApproveButtonText()
返回 ApproveButton 中的 FileChooserUI 内使用的文本。 |
String |
getApproveButtonToolTipText()
返回 ApproveButton 中使用的工具提示文本。 |
FileFilter[] |
getChoosableFileFilters()
获得用户可选择的文件过滤器列表。 |
boolean |
getControlButtonsAreShown()
返回 controlButtonsAreShown 属性的值。 |
File |
getCurrentDirectory()
返回当前目录。 |
String |
getDescription(File f)
返回文件描述。 |
String |
getDialogTitle()
获得 JFileChooser 的标题栏中所显示的字符串。 |
int |
getDialogType()
返回此对话框的类型。 |
boolean |
getDragEnabled()
获得 dragEnabled 属性的值。 |
FileFilter |
getFileFilter()
返回当前选择的文件过滤器。 |
int |
getFileSelectionMode()
返回当前的文件选择模式。 |
FileSystemView |
getFileSystemView()
返回文件系统视图。 |
FileView |
getFileView()
返回当前的文件视图。 |
Icon |
getIcon(File f)
返回此文件或文件类型的图标,这取决于系统。 |
String |
getName(File f)
返回文件名。 |
File |
getSelectedFile()
返回选中的文件。 |
File[] |
getSelectedFiles()
如果将文件选择器设置为允许选择多个文件,则返回选中文件的列表。 |
String |
getTypeDescription(File f)
返回文件类型。 |
FileChooserUI |
getUI()
获得实现此组件 L&F 的 UI 对象。 |
String |
getUIClassID()
返回一个指示 L&F 类名的字符串,该类负责呈现此组件。 |
boolean |
isAcceptAllFileFilterUsed()
返回是否使用 AcceptAll FileFilter 。 |
boolean |
isDirectorySelectionEnabled()
方便的调用,可根据当前的文件选择模式确定目录是否为可选择的。 |
boolean |
isFileHidingEnabled()
如果在文件选择器中不显示隐藏文件,则返回 true;否则返回 false。 |
boolean |
isFileSelectionEnabled()
方便的调用,可根据当前的文件选择模式确定文件是否为可选择的。 |
boolean |
isMultiSelectionEnabled()
如果可以选择多个文件,则返回 true。 |
boolean |
isTraversable(File f)
如果可以返回该文件(目录),则返回 true。 |
protected String |
paramString()
返回此 JFileChooser 的字符串表示形式。 |
void |
removeActionListener(ActionListener l)
从文件选择器中移除一个 ActionListener 。 |
boolean |
removeChoosableFileFilter(FileFilter f)
从用户可选择的文件过滤器列表中移除一个过滤器。 |
void |
rescanCurrentDirectory()
通知 UI 重新扫描当前目录的文件列表。 |
void |
resetChoosableFileFilters()
将可选择文件过滤器列表重置为其开始状态。 |
void |
setAcceptAllFileFilterUsed(boolean b)
确定是否将 AcceptAll FileFilter 用作可选择过滤器列表中一个可用选项。 |
void |
setAccessory(JComponent newAccessory)
设置 accessory 组件。 |
void |
setApproveButtonMnemonic(char mnemonic)
使用字符设置确认按钮的助记符。 |
void |
setApproveButtonMnemonic(int mnemonic)
使用数值键代码设置确认按钮的助记符。 |
void |
setApproveButtonText(String approveButtonText)
设置 FileChooserUI 中的 ApproveButton 内使用的文本。 |
void |
setApproveButtonToolTipText(String toolTipText)
设置 ApproveButton 中使用的工具提示文本。 |
void |
setControlButtonsAreShown(boolean b)
设置属性,指示在文件选择器中是否显示 approve 和 cancel 按钮。 |
void |
setCurrentDirectory(File dir)
设置当前目录。 |
void |
setDialogTitle(String dialogTitle)
设置显示在 JFileChooser 窗口标题栏的字符串。 |
void |
setDialogType(int dialogType)
设置此对话框的类型。 |
void |
setDragEnabled(boolean b)
设置 dragEnabled 属性,要在此组件上启用自动拖动处理(drag 和 drop 的第一部分),此属性必须为 true 。 |
void |
setFileFilter(FileFilter filter)
设置当前文件过滤器。 |
void |
setFileHidingEnabled(boolean b)
设置是否实现文件隐藏。 |
void |
setFileSelectionMode(int mode)
设置 JFileChooser ,以允许用户只选择文件、只选择目录,或者可选择文件和目录。 |
void |
setFileSystemView(FileSystemView fsv)
设置为访问和创建文件系统资源(如查找软驱和获得根驱动器列表), JFileChooser 所使用的文件系统视图。 |
void |
setFileView(FileView fileView)
设置用于检索 UI 信息的文件视图,如表示文件的图标或文件的类型描述。 |
void |
setMultiSelectionEnabled(boolean b)
设置文件选择器,以允许选择多个文件。 |
void |
setSelectedFile(File file)
设置选中的文件。 |
void |
setSelectedFiles(File[] selectedFiles)
如果将文件选择器设置为允许选择多个文件,则设置选中文件的列表。 |
protected void |
setup(FileSystemView view)
执行公共的构造方法初始化和设置。 |
int |
showDialog(Component parent,
String approveButtonText)
弹出具有自定义 approve 按钮的自定义文件选择器对话框。 |
int |
showOpenDialog(Component parent)
弹出一个 "Open File" 文件选择器对话框。 |
int |
showSaveDialog(Component parent)
弹出一个 "Save File" 文件选择器对话框。 |
void |
updateUI()
将 UI 属性重置为当前的外观值。 |
从类 javax.swing.JComponent 继承的方法 |
---|
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update |
从类 java.awt.Container 继承的方法 |
---|
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusBackward, transferFocusDownCycle, validate, validateTree |
从类 java.awt.Component 继承的方法 |
---|
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, 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, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
字段详细信息 |
---|
public static final int OPEN_DIALOG
JFileChooser
支持 "Open" 文件操作的类型值。
public static final int SAVE_DIALOG
JFileChooser
支持 "Save" 文件操作的类型值。
public static final int CUSTOM_DIALOG
JFileChooser
支持特定于开发人员文件操作的类型值。
public static final int CANCEL_OPTION
public static final int APPROVE_OPTION
public static final int ERROR_OPTION
public static final int FILES_ONLY
public static final int DIRECTORIES_ONLY
public static final int FILES_AND_DIRECTORIES
public static final String CANCEL_SELECTION
public static final String APPROVE_SELECTION
public static final String APPROVE_BUTTON_TEXT_CHANGED_PROPERTY
public static final String APPROVE_BUTTON_TOOL_TIP_TEXT_CHANGED_PROPERTY
public static final String APPROVE_BUTTON_MNEMONIC_CHANGED_PROPERTY
public static final String CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY
public static final String DIRECTORY_CHANGED_PROPERTY
public static final String SELECTED_FILE_CHANGED_PROPERTY
public static final String SELECTED_FILES_CHANGED_PROPERTY
public static final String MULTI_SELECTION_ENABLED_CHANGED_PROPERTY
public static final String FILE_SYSTEM_VIEW_CHANGED_PROPERTY
public static final String FILE_VIEW_CHANGED_PROPERTY
public static final String FILE_HIDING_CHANGED_PROPERTY
public static final String FILE_FILTER_CHANGED_PROPERTY
public static final String FILE_SELECTION_MODE_CHANGED_PROPERTY
public static final String ACCESSORY_CHANGED_PROPERTY
public static final String ACCEPT_ALL_FILE_FILTER_USED_CHANGED_PROPERTY
public static final String DIALOG_TITLE_CHANGED_PROPERTY
public static final String DIALOG_TYPE_CHANGED_PROPERTY
public static final String CHOOSABLE_FILE_FILTER_CHANGED_PROPERTY
protected AccessibleContext accessibleContext
构造方法详细信息 |
---|
public JFileChooser()
JFileChooser
。此默认目录取决于操作系统。在 Windows 上通常是“我的文档”,在 Unix 上是用户的主目录。
public JFileChooser(String currentDirectoryPath)
JFileChooser
。传入 null
字符串会导致文件选择器指向用户的默认目录。此默认目录取决于操作系统。在 Windows 上通常是“我的文档”,在 Unix 上是用户的主目录。
currentDirectoryPath
- 给出文件或目录路径的 String
public JFileChooser(File currentDirectory)
File
作为路径来构造一个 JFileChooser
。传入 null
文件会导致文件选择器指向用户的默认目录。此默认目录取决于操作系统。在 Windows 上通常是“我的文档”,在 Unix 上是用户的主目录。
currentDirectory
- 指出文件或目录路径的 File
对象public JFileChooser(FileSystemView fsv)
FileSystemView
构造一个 JFileChooser
。
public JFileChooser(File currentDirectory, FileSystemView fsv)
FileSystemView
构造一个 JFileChooser
。
public JFileChooser(String currentDirectoryPath, FileSystemView fsv)
FileSystemView
构造一个 JFileChooser
。
方法详细信息 |
---|
protected void setup(FileSystemView view)
public void setDragEnabled(boolean b)
dragEnabled
属性,要在此组件上启用自动拖动处理(drag 和 drop 的第一部分),此属性必须为 true
。为了让该拖动完成所需的任务,需要将 transferHandler
属性设置为非 null
的值。dragEnabled
属性的默认值为 false
。
启用自动拖动处理后,每当用户在项上按下鼠标按键,然后将鼠标移动几个像素后,多数外观就开始拖放操作。因此将此属性设置为 true
对选择方式有一些影响。
某些外观可能不支持自动拖放;它们会忽略此属性。通过修改组件以直接调用 TransferHandler
的 exportAsDrag
方法,从而在此外观下工作。
b
- 为 dragEnabled
属性设置的值
HeadlessException
- 如果 b
为 true
并且 GraphicsEnvironment.isHeadless()
返回 true
GraphicsEnvironment.isHeadless()
,
getDragEnabled()
,
JComponent.setTransferHandler(javax.swing.TransferHandler)
,
TransferHandler
public boolean getDragEnabled()
dragEnabled
属性的值。
dragEnabled
属性的值setDragEnabled(boolean)
public File getSelectedFile()
setFile
或者通过用户操作(如在 UI 中键入文件名,或者从 UI 中的列表内选择文件)来进行此设置。
setSelectedFile(java.io.File)
public void setSelectedFile(File file)
file
- 选中的文件getSelectedFile()
public File[] getSelectedFiles()
public void setSelectedFiles(File[] selectedFiles)
public File getCurrentDirectory()
setCurrentDirectory(java.io.File)
public void setCurrentDirectory(File dir)
null
会设置文件选择器指向用户的默认目录。此默认目录取决于操作系统。在 Windows 上通常是“我的文档”,在 Unix 上是用户的主目录。
如果作为 currentDirectory
所传入的文件不是一个目录,则使用该文件的父级作为 currentDirectory。如果该父级是不可遍历的,则会沿父级树向上查找,直到找到可遍历的目录,或者到达文件系统的根为止。
dir
- 要指向的当前目录getCurrentDirectory()
public void changeToParentDirectory()
getCurrentDirectory()
public void rescanCurrentDirectory()
public void ensureFileIsVisible(File f)
f
- 一个 File 对象public int showOpenDialog(Component parent) throws HeadlessException
parent
- 该对话框的父组件,可以为 null
;详情请参阅 showDialog
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 true。GraphicsEnvironment.isHeadless()
,
showDialog(java.awt.Component, java.lang.String)
public int showSaveDialog(Component parent) throws HeadlessException
parent
- 该对话框的父组件,可以为 null
;详情请参阅 showDialog
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 true。GraphicsEnvironment.isHeadless()
,
showDialog(java.awt.Component, java.lang.String)
public int showDialog(Component parent, String approveButtonText) throws HeadlessException
filechooser.showDialog(parentFrame, "Run Application");或者,以下代码也可以执行相同的操作:
JFileChooser chooser = new JFileChooser(null); chooser.setApproveButtonText("Run Application"); chooser.showDialog(parentFrame, null);
parent
参数确定两件事情:打开的对话框所依赖的窗体,以及组件(放置对话框时外观应该考虑该组件的位置)。如果 parent 是一个 Frame
对象(例如 JFrame
),则该对话框取决于该窗体,并且外观相对于窗体放置该对话框(例如在窗体上居中)。如果 parent 是一个组件,则该对话框取决于包含该组件的窗体,并且相对于该组件放置该对话框(例如在组件上居中)。如果 parent 为 null
,则该对话框取决于不可见的窗口,并且将其放置到与外观相关的位置,如屏幕的中央。
parent
- 该对话框的父组件,可以为 null
approveButtonText
- ApproveButton
的文本
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 true。GraphicsEnvironment.isHeadless()
protected JDialog createDialog(Component parent) throws HeadlessException
this
的新 JDialog
,在 parent
窗体中的 parent
上居中。可重写此方法以进一步地操作对话框、禁止调整大小、设置位置等等。例如:
class MyFileChooser extends JFileChooser { protected JDialog createDialog(Component parent) throws HeadlessException { JDialog dialog = super.createDialog(parent); dialog.setLocation(300, 200); dialog.setResizable(false); return dialog; } }
parent
- 该对话框的父组件,可以为 null
JDialog
HeadlessException
- 如果 GraphicsEnvironment.isHeadless() 返回 true。GraphicsEnvironment.isHeadless()
public boolean getControlButtonsAreShown()
controlButtonsAreShown
属性的值。
controlButtonsAreShown
属性的值setControlButtonsAreShown(boolean)
public void setControlButtonsAreShown(boolean b)
true
。始终显示这些按钮的外观将忽略此属性的值。此方法激发一个属性更改事件,使用 CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY
字符串值作为属性名。
b
- 如果不应显示控制按钮,则为 false
;否则为 true
getControlButtonsAreShown()
,
CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY
public int getDialogType()
JFileChooser.OPEN_DIALOG
。
setDialogType(int)
public void setDialogType(int dialogType)
OPEN_DIALOG
。同样,使用 SAVE_DIALOG
可让用户选择用于保存的文件。想要在除 "Open" 或 "Save" 以外的上下文中使用文件选择器,则使用 CUSTOM_DIALOG
。例如,您可能想要显示的文件选择器允许用户选择要执行的文件。注意,通常无需设置 JFileChooser
使用 CUSTOM_DIALOG
,因为调用 setApproveButtonText
就已经这样作了。默认的对话框类型是 JFileChooser.OPEN_DIALOG
。
dialogType
- 要显示的对话框的类型:
IllegalArgumentException
- 如果 dialogType
非法getDialogType()
,
setApproveButtonText(java.lang.String)
public void setDialogTitle(String dialogTitle)
JFileChooser
窗口标题栏的字符串。
dialogTitle
- 标题栏的新 String
getDialogTitle()
public String getDialogTitle()
JFileChooser
的标题栏中所显示的字符串。
setDialogTitle(java.lang.String)
public void setApproveButtonToolTipText(String toolTipText)
ApproveButton
中使用的工具提示文本。如果为 null
,则由 UI 对象确定该按钮的文本。
toolTipText
- 用于确认按钮的工具提示文本setApproveButtonText(java.lang.String)
,
setDialogType(int)
,
showDialog(java.awt.Component, java.lang.String)
public String getApproveButtonToolTipText()
ApproveButton
中使用的工具提示文本。如果为 null
,则由 UI 对象确定该按钮的文本。
setApproveButtonText(java.lang.String)
,
setDialogType(int)
,
showDialog(java.awt.Component, java.lang.String)
public int getApproveButtonMnemonic()
setApproveButtonMnemonic(int)
public void setApproveButtonMnemonic(int mnemonic)
mnemonic
- 用于助记符键的整数值getApproveButtonMnemonic()
public void setApproveButtonMnemonic(char mnemonic)
mnemonic
- 用于助记符键的 char 值getApproveButtonMnemonic()
public void setApproveButtonText(String approveButtonText)
FileChooserUI
中的 ApproveButton
内使用的文本。
approveButtonText
- ApproveButton
中使用的文本getApproveButtonText()
,
setDialogType(int)
,
showDialog(java.awt.Component, java.lang.String)
public String getApproveButtonText()
ApproveButton
中的 FileChooserUI
内使用的文本。如果为 null
,则由 UI 对象确定该按钮的文本。
通常该文本是 "Open" 或 "Save"。
ApproveButton
中使用的文本setApproveButtonText(java.lang.String)
,
setDialogType(int)
,
showDialog(java.awt.Component, java.lang.String)
public FileFilter[] getChoosableFileFilters()
FileFilter
数组addChoosableFileFilter(javax.swing.filechooser.FileFilter)
,
removeChoosableFileFilter(javax.swing.filechooser.FileFilter)
,
resetChoosableFileFilters()
public void addChoosableFileFilter(FileFilter filter)
setFileSelectionMode
。
filter
- 添加到可选择文件过滤器列表的 FileFilter
getChoosableFileFilters()
,
removeChoosableFileFilter(javax.swing.filechooser.FileFilter)
,
resetChoosableFileFilters()
,
setFileSelectionMode(int)
public boolean removeChoosableFileFilter(FileFilter f)
addChoosableFileFilter(javax.swing.filechooser.FileFilter)
,
getChoosableFileFilters()
,
resetChoosableFileFilters()
public void resetChoosableFileFilters()
AcceptAll
文件过滤器。
addChoosableFileFilter(javax.swing.filechooser.FileFilter)
,
getChoosableFileFilters()
,
removeChoosableFileFilter(javax.swing.filechooser.FileFilter)
public FileFilter getAcceptAllFileFilter()
AcceptAll
文件过滤器。例如在 Microsoft Windows 上,这会是“所有文件” (*.*)。
public boolean isAcceptAllFileFilterUsed()
AcceptAll FileFilter
。
AcceptAll FileFilter
,则返回 truesetAcceptAllFileFilterUsed(boolean)
public void setAcceptAllFileFilterUsed(boolean b)
AcceptAll FileFilter
用作可选择过滤器列表中一个可用选项。如果为 false,则从可用文件过滤器的列表中移除 AcceptAll
文件过滤器。如果为 true,则 AcceptAll
文件过滤器将成为可用的文件过滤器。
isAcceptAllFileFilterUsed()
,
getAcceptAllFileFilter()
,
setFileFilter(javax.swing.filechooser.FileFilter)
public JComponent getAccessory()
setAccessory(javax.swing.JComponent)
public void setAccessory(JComponent newAccessory)
注:如果有以前使用的 accessory,则应该取消注册该 accessory 已向文件选择器所注册的所有侦听器。
public void setFileSelectionMode(int mode)
JFileChooser
,以允许用户只选择文件、只选择目录,或者可选择文件和目录。默认值是 JFilesChooser.FILES_ONLY
。
mode
- 要显示的文件类型:
IllegalArgumentException
- 如果 mode
是非法的文件选择模式getFileSelectionMode()
public int getFileSelectionMode()
JFilesChooser.FILES_ONLY
。
setFileSelectionMode(int)
public boolean isFileSelectionEnabled()
setFileSelectionMode(int)
,
getFileSelectionMode()
public boolean isDirectorySelectionEnabled()
setFileSelectionMode(int)
,
getFileSelectionMode()
public void setMultiSelectionEnabled(boolean b)
b
- 如果可以选择多个文件,则为 trueisMultiSelectionEnabled()
public boolean isMultiSelectionEnabled()
setMultiSelectionEnabled(boolean)
public boolean isFileHidingEnabled()
setFileHidingEnabled(boolean)
public void setFileHidingEnabled(boolean b)
FileView
完成。
b
- 确定是否开启文件隐藏的 boolean 值isFileHidingEnabled()
public void setFileFilter(FileFilter filter)
filter
- 要使用的新的当前文件过滤器getFileFilter()
public FileFilter getFileFilter()
setFileFilter(javax.swing.filechooser.FileFilter)
,
addChoosableFileFilter(javax.swing.filechooser.FileFilter)
public void setFileView(FileView fileView)
getFileView()
public FileView getFileView()
setFileView(javax.swing.filechooser.FileView)
public String getName(File f)
f
- File
f
文件名的 String
FileView.getName(java.io.File)
public String getDescription(File f)
f
- File
f
文件描述的 String
FileView.getDescription(java.io.File)
public String getTypeDescription(File f)
f
- File
f
文件类型描述的 String
FileView.getTypeDescription(java.io.File)
public Icon getIcon(File f)
f
- File
Icon
FileView.getIcon(java.io.File)
public boolean isTraversable(File f)
f
- File
FileView.isTraversable(java.io.File)
public boolean accept(File f)
f
- File
FileFilter.accept(java.io.File)
public void setFileSystemView(FileSystemView fsv)
JFileChooser
所使用的文件系统视图。
fsv
- 新的 FileSystemView
FileSystemView
public FileSystemView getFileSystemView()
FileSystemView
对象setFileSystemView(javax.swing.filechooser.FileSystemView)
public void approveSelection()
APPROVE_SELECTION
的命令字符串激发一个操作事件。
APPROVE_SELECTION
public void cancelSelection()
CANCEL_SELECTION
的命令字符串激发一个操作事件。
CANCEL_SELECTION
public void addActionListener(ActionListener l)
ActionListener
。
l
- 要添加的侦听器approveSelection()
,
cancelSelection()
public void removeActionListener(ActionListener l)
ActionListener
。
l
- 要移除的侦听器addActionListener(java.awt.event.ActionListener)
public ActionListener[] getActionListeners()
ActionListener
;如果当前没有注册任何操作侦听器,则返回一个空数组addActionListener(java.awt.event.ActionListener)
,
removeActionListener(java.awt.event.ActionListener)
protected void fireActionPerformed(String command)
command
参数以延迟方式创建事件实例。
EventListenerList
public void updateUI()
JComponent
中的 updateUI
JComponent.updateUI()
public String getUIClassID()
JComponent
中的 getUIClassID
JComponent.getUIClassID()
,
UIDefaults.getUI(javax.swing.JComponent)
public FileChooserUI getUI()
protected String paramString()
JFileChooser
的字符串表示形式。此方法仅在进行调试时使用,对于各个实现,所返回字符串的内容和格式可能有所不同。返回的字符串可能为空,但不可能为 null
。
JComponent
中的 paramString
JFileChooser
的字符串表示形式public AccessibleContext getAccessibleContext()
Accessible
中的 getAccessibleContext
JComponent
中的 getAccessibleContext
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。