javax.swing.JFileChooser - JFileChooser 为用户选择文件提供了一种简单的机制。

javax.swing

接口

类

异常

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JFileChooser

所有已实现的接口：: ImageObserver, MenuContainer, Serializable, Accessible

public class JFileChooser
extends JComponent

implements Accessible
extends JComponent
implements Accessible

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, JDK 1.6 中文手册

javax.swing

接口

类

异常

javax.swing 类 JFileChooser

javax.swing
类 JFileChooser