- java.lang.Object
-
- java.awt.Component
-
- java.awt.Container
-
- javax.swing.JComponent
-
- javax.swing.JFileChooser
-
- 实现的所有接口
-
ImageObserver
,MenuContainer
,Serializable
,Accessible
@JavaBean(defaultProperty="UI", description="A component which allows for the interactive selection of a file.")public class JFileChooserextends JComponentimplements Accessible
JFileChooser
为用户提供了一种选择文件的简单机制。 有关使用JFileChooser
信息,请参阅“Java教程”中的 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 。
- 从以下版本开始:
- 1.2
- 另请参见:
- Serialized Form
-
-
嵌套类汇总
嵌套类 变量和类型 类 描述 protected class
JFileChooser.AccessibleJFileChooser
此类实现JFileChooser
类的可访问性支持。-
嵌套类/接口声明在类 javax.swing.JComponent
JComponent.AccessibleJComponent
-
嵌套类/接口声明在类 java.awt.Container
Container.AccessibleAWTContainer
-
-
字段汇总
-
声明的属性在类 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
-
Fields declared in interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
-
-
构造方法摘要
构造方法 构造器 描述 JFileChooser()
构造一个指向用户默认目录的JFileChooser
。JFileChooser(File currentDirectory)
构造一个JFileChooser
使用给定File
作为路径。JFileChooser(File currentDirectory, FileSystemView fsv)
构造一个JFileChooser
使用给定的当前目录和FileSystemView
。JFileChooser(String currentDirectoryPath)
使用给定路径构造JFileChooser
。JFileChooser(String currentDirectoryPath, FileSystemView fsv)
构造一个JFileChooser
使用给定的当前目录路径和FileSystemView
。JFileChooser(FileSystemView fsv)
构造一个JFileChooser
使用给定的FileSystemView
。
-
方法摘要
所有方法 实例方法 具体的方法 变量和类型 方法 描述 boolean
accept(File f)
如果应显示该文件,则返回true。void
addActionListener(ActionListener l)
将ActionListener
添加到文件选择器。void
addChoosableFileFilter(FileFilter filter)
将过滤器添加到用户可选文件过滤器列表中。void
approveSelection()
当用户点击“批准”按钮时(由默认情况下标记为“打开”或“保存”),由UI调用。void
cancelSelection()
当用户选择“取消”按钮时由UI调用。void
changeToParentDirectory()
将要设置的目录更改为当前目录的父目录。protected JDialog
createDialog(Component parent)
创建并返回JDialog
包装this
中心位于parent
中的parent
。void
ensureFileIsVisible(File f)
确保指定的文件是可查看的,而不是隐藏的。protected void
fireActionPerformed(String command)
通知所有已注册对此事件类型的通知感兴趣的听众。FileFilter
getAcceptAllFileFilter()
返回AcceptAll
文件筛选器。AccessibleContext
getAccessibleContext()
获取与此JFileChooser关联的AccessibleContext。JComponent
getAccessory()
返回附件组件。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;否则返回true。 否则,返回false。boolean
isFileSelectionEnabled()
方便调用,根据当前文件选择模式确定文件是否可选。boolean
isMultiSelectionEnabled()
如果可以选择多个文件,则返回true。boolean
isTraversable(File f)
如果可以访问文件(目录),则返回true。protected String
paramString()
返回此JFileChooser
的字符串表示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)
设置附件组件。void
setApproveButtonMnemonic(char mnemonic)
使用字符设置批准按钮的助记符。void
setApproveButtonMnemonic(int mnemonic)
使用数字键代码设置批准按钮的助记符。void
setApproveButtonText(String approveButtonText)
设置在使用的文本ApproveButton
在FileChooserUI
。void
setApproveButtonToolTipText(String toolTipText)
设置ApproveButton
使用的工具提示文本。void
setControlButtonsAreShown(boolean b)
设置指示是否在文件选择器中显示 批准和 取消按钮的属性。void
setCurrentDirectory(File dir)
设置当前目录。void
setDialogTitle(String dialogTitle)
设置JFileChooser
窗口标题栏中的字符串。void
setDialogType(int dialogType)
设置此对话框的类型。void
setDragEnabled(boolean b)
设置dragEnabled
属性,该属性必须为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)
使用自定义批准按钮弹出自定义文件选择器对话框。int
showOpenDialog(Component parent)
弹出“打开文件”文件选择器对话框。int
showSaveDialog(Component parent)
弹出“保存文件”文件选择器对话框。void
updateUI()
将UI属性重置为当前外观的值。-
声明方法的类 javax.swing.JComponent
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, 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, isPaintingOrigin, 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, 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, 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, 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, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
-
-
-
-
字段详细信息
-
OPEN_DIALOG
public static final int OPEN_DIALOG
键入值,表示JFileChooser
支持“打开”文件操作。- 另请参见:
- 常数字段值
-
SAVE_DIALOG
public static final int SAVE_DIALOG
键入值,表示JFileChooser
支持“保存”文件操作。- 另请参见:
- 常数字段值
-
CUSTOM_DIALOG
public static final int CUSTOM_DIALOG
键入值,表示JFileChooser
支持开发人员指定的文件操作。- 另请参见:
- 常数字段值
-
CANCEL_OPTION
public static final int CANCEL_OPTION
如果选择取消,则返回值。- 另请参见:
- 常数字段值
-
APPROVE_OPTION
public static final int APPROVE_OPTION
如果选择了批准(是,确定),则返回值。- 另请参见:
- 常数字段值
-
ERROR_OPTION
public static final int ERROR_OPTION
发生错误时返回值。- 另请参见:
- 常数字段值
-
FILES_ONLY
public static final int FILES_ONLY
仅显示文件的说明。- 另请参见:
- 常数字段值
-
DIRECTORIES_ONLY
public static final int DIRECTORIES_ONLY
仅显示目录的说明。- 另请参见:
- 常数字段值
-
FILES_AND_DIRECTORIES
public static final int FILES_AND_DIRECTORIES
显示文件和目录的说明。- 另请参见:
- 常数字段值
-
APPROVE_BUTTON_TEXT_CHANGED_PROPERTY
public static final String APPROVE_BUTTON_TEXT_CHANGED_PROPERTY
标识批准(是,确定)按钮上文本的更改。- 另请参见:
- 常数字段值
-
APPROVE_BUTTON_TOOL_TIP_TEXT_CHANGED_PROPERTY
public static final String APPROVE_BUTTON_TOOL_TIP_TEXT_CHANGED_PROPERTY
标识批准(是,确定)按钮的工具提示文本中的更改。- 另请参见:
- 常数字段值
-
APPROVE_BUTTON_MNEMONIC_CHANGED_PROPERTY
public static final String APPROVE_BUTTON_MNEMONIC_CHANGED_PROPERTY
标识批准(是,确定)按钮的助记符更改。- 另请参见:
- 常数字段值
-
CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY
public static final String CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY
显示控制按钮的说明。- 另请参见:
- 常数字段值
-
DIRECTORY_CHANGED_PROPERTY
public static final String DIRECTORY_CHANGED_PROPERTY
标识用户的目录更改。- 另请参见:
- 常数字段值
-
SELECTED_FILE_CHANGED_PROPERTY
public static final String SELECTED_FILE_CHANGED_PROPERTY
标识用户单个文件选择的更改。- 另请参见:
- 常数字段值
-
SELECTED_FILES_CHANGED_PROPERTY
public static final String SELECTED_FILES_CHANGED_PROPERTY
标识用户的多文件选择中的更改。- 另请参见:
- 常数字段值
-
MULTI_SELECTION_ENABLED_CHANGED_PROPERTY
public static final String MULTI_SELECTION_ENABLED_CHANGED_PROPERTY
启用多文件选择。- 另请参见:
- 常数字段值
-
FILE_SYSTEM_VIEW_CHANGED_PROPERTY
public static final String FILE_SYSTEM_VIEW_CHANGED_PROPERTY
说使用不同的对象来查找系统上的可用驱动器。- 另请参见:
- 常数字段值
-
FILE_VIEW_CHANGED_PROPERTY
public static final String FILE_VIEW_CHANGED_PROPERTY
说使用不同的对象来检索文件信息。- 另请参见:
- 常数字段值
-
FILE_HIDING_CHANGED_PROPERTY
public static final String FILE_HIDING_CHANGED_PROPERTY
标识display-hidden-files属性中的更改。- 另请参见:
- 常数字段值
-
FILE_FILTER_CHANGED_PROPERTY
public static final String FILE_FILTER_CHANGED_PROPERTY
用户更改了要显示的文件类型。- 另请参见:
- 常数字段值
-
FILE_SELECTION_MODE_CHANGED_PROPERTY
public static final String FILE_SELECTION_MODE_CHANGED_PROPERTY
标识选择类型的变化(单个,多个等)。- 另请参见:
- 常数字段值
-
ACCESSORY_CHANGED_PROPERTY
public static final String ACCESSORY_CHANGED_PROPERTY
表示正在使用不同的附件组件(例如,预览文件)。- 另请参见:
- 常数字段值
-
ACCEPT_ALL_FILE_FILTER_USED_CHANGED_PROPERTY
public static final String ACCEPT_ALL_FILE_FILTER_USED_CHANGED_PROPERTY
标识是否使用AcceptAllFileFilter。- 另请参见:
- 常数字段值
-
DIALOG_TITLE_CHANGED_PROPERTY
public static final String DIALOG_TITLE_CHANGED_PROPERTY
标识对话框标题中的更改。- 另请参见:
- 常数字段值
-
DIALOG_TYPE_CHANGED_PROPERTY
public static final String DIALOG_TYPE_CHANGED_PROPERTY
标识所显示文件类型的更改(仅文件,仅限目录,或文件和目录)。- 另请参见:
- 常数字段值
-
CHOOSABLE_FILE_FILTER_CHANGED_PROPERTY
public static final String CHOOSABLE_FILE_FILTER_CHANGED_PROPERTY
标识用户可以选择的预定义文件筛选器列表中的更改。- 另请参见:
- 常数字段值
-
accessibleContext
protected AccessibleContext accessibleContext
AccessibleContext
与此JFileChooser
相关联
-
-
构造方法详细信息
-
JFileChooser
public JFileChooser()
构造一个指向用户默认目录的JFileChooser
。 此默认值取决于操作系统。 它通常是Windows上的“My Documents”文件夹,以及Unix上用户的主目录。
-
JFileChooser
public JFileChooser(String currentDirectoryPath)
使用给定路径构造JFileChooser
。null
字符串会导致文件选择器指向用户的默认目录。 此默认值取决于操作系统。 它通常是Windows上的“My Documents”文件夹,以及Unix上用户的主目录。- 参数
-
currentDirectoryPath
-String
给出文件或目录的路径
-
JFileChooser
public JFileChooser(File currentDirectory)
构造一个JFileChooser
使用给定File
作为路径。null
文件会导致文件选择器指向用户的默认目录。 此默认值取决于操作系统。 它通常是Windows上的“My Documents”文件夹,以及Unix上用户的主目录。- 参数
-
currentDirectory
- 指定文件或目录路径的File
对象
-
JFileChooser
public JFileChooser(FileSystemView fsv)
构造一个JFileChooser
使用给定的FileSystemView
。- 参数
-
fsv
- aFileSystemView
-
JFileChooser
public JFileChooser(File currentDirectory, FileSystemView fsv)
构造一个JFileChooser
使用给定的当前目录和FileSystemView
。- 参数
-
currentDirectory
- 指定文件或目录路径的File
对象 -
fsv
- aFileSystemView
-
JFileChooser
public JFileChooser(String currentDirectoryPath, FileSystemView fsv)
构造一个JFileChooser
使用给定的当前目录路径和FileSystemView
。- 参数
-
currentDirectoryPath
-String
指定文件或目录的路径 -
fsv
- aFileSystemView
-
-
方法详细信息
-
setup
protected void setup(FileSystemView view)
执行常见的构造函数初始化和设置。- 参数
-
view
- 用于设置的FileSystemView
-
setDragEnabled
@BeanProperty(bound=false, description="determines whether automatic drag handling is enabled")public void setDragEnabled(boolean b)
设置dragEnabled
属性,该属性必须为true
才能在此组件上启用自动拖动处理(拖放的第一部分)。 需要将transferHandler
属性设置为非null
值才能执行任何操作。dragEnabled
属性的默认值是false
。启用自动拖动处理后,只要用户在项目上按下鼠标按钮然后将鼠标移动几个像素,大多数外观都会开始拖放操作。 因此,将此属性设置为
true
会对选择的行为产生微妙的影响。一些外观可能不支持自动拖放; 他们会忽略这个属性。 您可以解决这样的外观和修改组件以直接调用感觉
exportAsDrag
一个方法TransferHandler
。- 参数
-
b
-dragEnabled
属性设置为的值 - 异常
-
HeadlessException
- 如果b
是true
而GraphicsEnvironment.isHeadless()
返回true
- 从以下版本开始:
- 1.4
- 另请参见:
-
GraphicsEnvironment.isHeadless()
,getDragEnabled()
,JComponent.setTransferHandler(javax.swing.TransferHandler)
,TransferHandler
-
getDragEnabled
public boolean getDragEnabled()
获取dragEnabled
属性的值。- 结果
-
dragEnabled
属性的值 - 从以下版本开始:
- 1.4
- 另请参见:
-
setDragEnabled(boolean)
-
getSelectedFile
public File getSelectedFile()
返回所选文件。 这可以由程序员通过setSelectedFile
或用户操作设置,例如在UI中键入文件名或从UI中的列表中选择文件。- 结果
- 选定的文件
- 另请参见:
-
setSelectedFile(java.io.File)
-
setSelectedFile
@BeanProperty(preferred=true)public void setSelectedFile(File file)
设置所选文件。 如果文件的父目录不是当前目录,则将当前目录更改为文件的父目录。- 参数
-
file
- 所选文件 - 另请参见:
-
getSelectedFile()
-
getSelectedFiles
public File[] getSelectedFiles()
如果文件选择器设置为允许多个选择,则返回所选文件的列表。- 结果
- 一系列选定的
File
-
setSelectedFiles
@BeanProperty(description="The list of selected files if the chooser is in multiple selection mode.")public void setSelectedFiles(File[] selectedFiles)
如果文件选择器设置为允许多个选择,则设置所选文件的列表。- 参数
-
selectedFiles
- 要选择的阵列File
-
getCurrentDirectory
public File getCurrentDirectory()
返回当前目录。- 结果
- 当前目录
- 另请参见:
-
setCurrentDirectory(java.io.File)
-
setCurrentDirectory
@BeanProperty(preferred=true, description="The directory that the JFileChooser is showing files of.")public void setCurrentDirectory(File dir)
设置当前目录。null
将文件选择器设置为指向用户的默认目录。 此默认值取决于操作系统。 它通常是Windows上的“My Documents”文件夹,以及Unix上用户的主目录。 如果以currentDirectory
传入的文件不是目录,则该文件的父文件将用作currentDirectory。 如果父级不可遍历,那么它将向上遍历父树,直到找到可遍历的目录,或者命中文件系统的根目录。- 参数
-
dir
- 要指向的当前目录 - 另请参见:
-
getCurrentDirectory()
-
changeToParentDirectory
public void changeToParentDirectory()
将要设置的目录更改为当前目录的父目录。- 另请参见:
-
getCurrentDirectory()
-
rescanCurrentDirectory
public void rescanCurrentDirectory()
告诉UI从当前目录重新扫描其文件列表。
-
ensureFileIsVisible
public void ensureFileIsVisible(File f)
确保指定的文件是可查看的,而不是隐藏的。- 参数
-
f
- 一个File对象
-
showOpenDialog
public int showOpenDialog(Component parent) throws HeadlessException
弹出“打开文件”文件选择器对话框。 请注意,批准按钮中显示的文本由L&F确定。- 参数
-
parent
- 对话框的父组件,可以是null
; 详情请见showDialog
- 结果
- 弹出窗口中文件选择器的返回状态:
- JFileChooser.CANCEL_OPTION
- JFileChooser.APPROVE_OPTION
- JFileChooser.ERROR_OPTION如果发生错误或对话框被解除
- 异常
-
HeadlessException
- 如果GraphicsEnvironment.isHeadless()返回true。 - 另请参见:
-
GraphicsEnvironment.isHeadless()
,showDialog(java.awt.Component, java.lang.String)
-
showSaveDialog
public int showSaveDialog(Component parent) throws HeadlessException
弹出“保存文件”文件选择器对话框。 请注意,批准按钮中显示的文本由L&F确定。- 参数
-
parent
- 对话框的父组件,可以是null
; 有关详细信息,请参阅showDialog
- 结果
- 弹出窗口中文件选择器的返回状态:
- JFileChooser.CANCEL_OPTION
- JFileChooser.APPROVE_OPTION
- JFileChooser.ERROR_OPTION如果发生错误或对话框被解除
- 异常
-
HeadlessException
- 如果GraphicsEnvironment.isHeadless()返回true。 - 另请参见:
-
GraphicsEnvironment.isHeadless()
,showDialog(java.awt.Component, java.lang.String)
-
showDialog
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
参数确定两件事:打开对话框所依赖的框架以及放置对话框时外观应考虑的位置的组件。 如果父对象是Frame
对象(例如JFrame
),则对话框取决于框架以及对话框相对于框架的外观(例如,在框架上居中)。 如果父组件是组件,则对话框取决于包含组件的框架,并且相对于组件定位(例如,在组件上居中)。 如果父级是null
,则对话框取决于没有可见窗口,并且它被放置在依赖于外观的位置,例如屏幕的中心。- 参数
-
parent
- 对话框的父组件; 可以是null
-
approveButtonText
-该文ApproveButton
- 结果
- 弹出窗口中文件选择器的返回状态:
- JFileChooser.CANCEL_OPTION
- JFileChooser.APPROVE_OPTION
- JFileChooser.ERROR_OPTION如果发生错误或对话框被解除
- 异常
-
HeadlessException
- 如果GraphicsEnvironment.isHeadless()返回true。 - 另请参见:
-
GraphicsEnvironment.isHeadless()
-
createDialog
protected JDialog createDialog(Component parent) throws HeadlessException
创建并返回JDialog
包装this
中心位于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。 - 从以下版本开始:
- 1.4
- 另请参见:
-
GraphicsEnvironment.isHeadless()
-
getControlButtonsAreShown
public boolean getControlButtonsAreShown()
返回controlButtonsAreShown
属性的值。- 结果
-
controlButtonsAreShown
属性的值 - 从以下版本开始:
- 1.3
- 另请参见:
-
setControlButtonsAreShown(boolean)
-
setControlButtonsAreShown
@BeanProperty(preferred=true, description="Sets whether the approve & cancel buttons are shown.")public void setControlButtonsAreShown(boolean b)
设置指示是否在文件选择器中显示批准和取消按钮的属性。 默认情况下,此属性为true
。 始终显示这些按钮的外观将忽略此属性的值。 此方法使用字符串值CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY
作为属性的名称来触发属性更改的事件。- 参数
-
b
-false
如果不显示控制按钮; 否则,true
- 从以下版本开始:
- 1.3
- 另请参见:
-
getControlButtonsAreShown()
,CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY
-
getDialogType
public int getDialogType()
返回此对话框的类型。 默认值为JFileChooser.OPEN_DIALOG
。- 结果
- 要显示的对话框类型:
- JFileChooser.OPEN_DIALOG
- JFileChooser.SAVE_DIALOG
- JFileChooser.CUSTOM_DIALOG
- 另请参见:
-
setDialogType(int)
-
setDialogType
@BeanProperty(preferred=true, enumerationValues={"JFileChooser.OPEN_DIALOG","JFileChooser.SAVE_DIALOG","JFileChooser.CUSTOM_DIALOG"}, description="The type (open, save, custom) of the JFileChooser.")public void setDialogType(int dialogType)
设置此对话框的类型。 如果要调出用户可用于打开文件的文件选择器,请使用OPEN_DIALOG
。 同样,使用SAVE_DIALOG
让用户选择要保存的文件。 如果要在“打开”或“保存”以外的上下文中使用文件选择器,请使用CUSTOM_DIALOG
。 例如,您可能想要调出一个允许用户选择要执行的文件的文件选择器。 请注意,您通常不需要将JFileChooser
设置为使用CUSTOM_DIALOG
因为拨打setApproveButtonText
会为您执行此操作。 默认对话框类型为JFileChooser.OPEN_DIALOG
。- 参数
-
dialogType
- 要显示的对话框类型:- JFileChooser.OPEN_DIALOG
- JFileChooser.SAVE_DIALOG
- JFileChooser.CUSTOM_DIALOG
- 异常
-
IllegalArgumentException
- 如果dialogType
不合法 - 另请参见:
-
getDialogType()
,setApproveButtonText(java.lang.String)
-
setDialogTitle
@BeanProperty(preferred=true, description="The title of the JFileChooser dialog window.")public void setDialogTitle(String dialogTitle)
设置JFileChooser
窗口标题栏中的字符串。- 参数
-
dialogTitle
- 标题栏的新String
- 另请参见:
-
getDialogTitle()
-
getDialogTitle
public String getDialogTitle()
获取JFileChooser
标题栏中的字符串。- 结果
-
JFileChooser
窗口标题栏中的字符串 - 另请参见:
-
setDialogTitle(java.lang.String)
-
setApproveButtonToolTipText
@BeanProperty(preferred=true, description="The tooltip text for the ApproveButton.")public void setApproveButtonToolTipText(String toolTipText)
设置ApproveButton
使用的工具提示文本。 如果是null
,UI对象将确定按钮的文本。- 参数
-
toolTipText
- 批准按钮的工具提示文本 - 另请参见:
-
setApproveButtonText(java.lang.String)
,setDialogType(int)
,showDialog(java.awt.Component, java.lang.String)
-
getApproveButtonToolTipText
public String getApproveButtonToolTipText()
返回ApproveButton
使用的工具提示文本。 如果是null
,UI对象将确定按钮的文本。- 结果
- 用于批准按钮的工具提示文本
- 另请参见:
-
setApproveButtonText(java.lang.String)
,setDialogType(int)
,showDialog(java.awt.Component, java.lang.String)
-
getApproveButtonMnemonic
public int getApproveButtonMnemonic()
返回批准按钮的助记符。- 结果
- 助记键的整数值
- 另请参见:
-
setApproveButtonMnemonic(int)
-
setApproveButtonMnemonic
@BeanProperty(preferred=true, description="The mnemonic key accelerator for the ApproveButton.")public void setApproveButtonMnemonic(int mnemonic)
使用数字键代码设置批准按钮的助记符。- 参数
-
mnemonic
- 助记键的整数值 - 另请参见:
-
getApproveButtonMnemonic()
-
setApproveButtonMnemonic
public void setApproveButtonMnemonic(char mnemonic)
使用字符设置批准按钮的助记符。- 参数
-
mnemonic
- 助记键的字符值 - 另请参见:
-
getApproveButtonMnemonic()
-
setApproveButtonText
@BeanProperty(preferred=true, description="The text that goes in the ApproveButton.")public void setApproveButtonText(String approveButtonText)
设置在使用的文本ApproveButton
在FileChooserUI
。- 参数
-
approveButtonText
-在使用的文本ApproveButton
- 另请参见:
-
getApproveButtonText()
,setDialogType(int)
,showDialog(java.awt.Component, java.lang.String)
-
getApproveButtonText
public String getApproveButtonText()
返回在使用的文本ApproveButton
在FileChooserUI
。 如果是null
,则UI对象将确定按钮的文本。 通常,这将是“打开”或“保存”。- 结果
-
ApproveButton
使用的ApproveButton
- 另请参见:
-
setApproveButtonText(java.lang.String)
,setDialogType(int)
,showDialog(java.awt.Component, java.lang.String)
-
getChoosableFileFilters
@BeanProperty(bound=false)public FileFilter[] getChoosableFileFilters()
获取用户可选择文件筛选器的列表。- 结果
- 包含所有
FileFilter
文件过滤器的FileFilter
数组 - 另请参见:
-
addChoosableFileFilter(javax.swing.filechooser.FileFilter)
,removeChoosableFileFilter(javax.swing.filechooser.FileFilter)
,resetChoosableFileFilters()
-
addChoosableFileFilter
@BeanProperty(preferred=true, description="Adds a filter to the list of user choosable file filters.")public void addChoosableFileFilter(FileFilter filter)
将过滤器添加到用户可选文件过滤器列表中。 有关设置文件选择模式的信息,请参阅setFileSelectionMode
。- 参数
-
filter
- 将FileFilter
添加到FileFilter
文件过滤列表中 - 另请参见:
-
getChoosableFileFilters()
,removeChoosableFileFilter(javax.swing.filechooser.FileFilter)
,resetChoosableFileFilters()
,setFileSelectionMode(int)
-
removeChoosableFileFilter
public boolean removeChoosableFileFilter(FileFilter f)
从用户可选择文件筛选器列表中删除筛选器。 如果删除了文件筛选器,则返回true。- 参数
-
f
- 要删除的文件筛选器 - 结果
- 如果删除了文件过滤器,则返回true,否则返回false
- 另请参见:
-
addChoosableFileFilter(javax.swing.filechooser.FileFilter)
,getChoosableFileFilters()
,resetChoosableFileFilters()
-
resetChoosableFileFilters
public void resetChoosableFileFilters()
将可选择文件筛选器列表重置为其启动状态。 通常,这将删除所有添加的文件筛选器,同时保留AcceptAll
文件筛选器。
-
getAcceptAllFileFilter
@BeanProperty(bound=false)public FileFilter getAcceptAllFileFilter()
返回AcceptAll
文件筛选器。 例如,在Microsoft Windows上,这将是所有文件(*。*)。- 结果
-
AcceptAll
文件过滤器
-
isAcceptAllFileFilterUsed
public boolean isAcceptAllFileFilterUsed()
返回是否使用AcceptAll FileFilter
。- 结果
- 如果使用
AcceptAll FileFilter
则为true - 从以下版本开始:
- 1.3
- 另请参见:
-
setAcceptAllFileFilterUsed(boolean)
-
setAcceptAllFileFilterUsed
@BeanProperty(preferred=true, description="Sets whether the AcceptAll FileFilter is used as an available choice in the choosable filter list.")public void setAcceptAllFileFilterUsed(boolean b)
确定AcceptAll FileFilter
是否在可选择的筛选器列表中用作可用选项。 如果为false,AcceptAll
可用文件筛选器列表中删除AcceptAll
文件筛选器。 如果为true,AcceptAll
文件过滤器将成为主动使用的文件过滤器。- 参数
-
b
-boolean
,用于确定AcceptAll
文件过滤器是否可在可选过滤器列表中选择 - 从以下版本开始:
- 1.3
- 另请参见:
-
isAcceptAllFileFilterUsed()
,getAcceptAllFileFilter()
,setFileFilter(javax.swing.filechooser.FileFilter)
-
getAccessory
public JComponent getAccessory()
返回附件组件。- 结果
- 这个JFileChooser的附件组件,或者为null
- 另请参见:
-
setAccessory(javax.swing.JComponent)
-
setAccessory
@BeanProperty(preferred=true, description="Sets the accessory component on the JFileChooser.")public void setAccessory(JComponent newAccessory)
设置附件组件。 附件通常用于显示所选文件的预览图像; 但是,它可以用于程序员希望的任何东西,例如额外的自定义文件选择器控件。注意:如果有以前的附件,则应取消注册附件可能已在文件选择器中注册的任何侦听器。
- 参数
-
newAccessory
- 要设置的附件组件
-
setFileSelectionMode
@BeanProperty(preferred=true, enumerationValues={"JFileChooser.FILES_ONLY","JFileChooser.DIRECTORIES_ONLY","JFileChooser.FILES_AND_DIRECTORIES"}, description="Sets the types of files that the JFileChooser can choose.")public void setFileSelectionMode(int mode)
设置JFileChooser
以允许用户只选择文件,只选择目录,或选择文件和目录。 默认值为JFilesChooser.FILES_ONLY
。- 参数
-
mode
- 要显示的文件类型:- JFileChooser.FILES_ONLY
- JFileChooser.DIRECTORIES_ONLY
- JFileChooser.FILES_AND_DIRECTORIES
- 异常
-
IllegalArgumentException
- 如果mode
是非法文件选择模式 - 另请参见:
-
getFileSelectionMode()
-
getFileSelectionMode
public int getFileSelectionMode()
返回当前文件选择模式。 默认值为JFilesChooser.FILES_ONLY
。- 结果
- 要显示的文件类型,以下之一:
- JFileChooser.FILES_ONLY
- JFileChooser.DIRECTORIES_ONLY
- JFileChooser.FILES_AND_DIRECTORIES
- 另请参见:
-
setFileSelectionMode(int)
-
isFileSelectionEnabled
@BeanProperty(bound=false)public boolean isFileSelectionEnabled()
方便调用,根据当前文件选择模式确定文件是否可选。- 结果
- 如果文件是可选的,则为true,否则为false
- 另请参见:
-
setFileSelectionMode(int)
,getFileSelectionMode()
-
isDirectorySelectionEnabled
@BeanProperty(bound=false)public boolean isDirectorySelectionEnabled()
方便调用,根据当前文件选择模式确定目录是否可选。- 结果
- 如果目录可选,则为true,否则为false
- 另请参见:
-
setFileSelectionMode(int)
,getFileSelectionMode()
-
setMultiSelectionEnabled
@BeanProperty(description="Sets multiple file selection mode.")public void setMultiSelectionEnabled(boolean b)
设置文件选择器以允许多个文件选择。- 参数
-
b
- 如果可以选择多个文件,b
true - 另请参见:
-
isMultiSelectionEnabled()
-
isMultiSelectionEnabled
public boolean isMultiSelectionEnabled()
如果可以选择多个文件,则返回true。- 结果
- 如果可以选择多个文件,则为true
- 另请参见:
-
setMultiSelectionEnabled(boolean)
-
isFileHidingEnabled
public boolean isFileHidingEnabled()
如果文件选择器中未显示隐藏文件,则返回true;否则返回true。 否则,返回false。- 结果
- 文件隐藏属性的状态
- 另请参见:
-
setFileHidingEnabled(boolean)
-
setFileHidingEnabled
@BeanProperty(preferred=true, description="Sets file hiding on or off.")public void setFileHidingEnabled(boolean b)
设置文件隐藏或关闭。 如果为true,则隐藏文件不会显示在文件选择器中。 确定显示哪些文件的工作由FileView
完成。- 参数
-
b
- 确定是否打开文件隐藏的布尔值 - 另请参见:
-
isFileHidingEnabled()
-
setFileFilter
@BeanProperty(preferred=true, description="Sets the File Filter used to filter out files of type.")public void setFileFilter(FileFilter filter)
设置当前文件筛选器。 文件选择器使用文件筛选器从用户视图中筛选出文件。- 参数
-
filter
- 要使用的新当前文件筛选器 - 另请参见:
-
getFileFilter()
-
getFileFilter
public FileFilter getFileFilter()
返回当前选定的文件筛选器。
-
setFileView
@BeanProperty(preferred=true, description="Sets the File View used to get file type information.")public void setFileView(FileView fileView)
设置用于检索UI信息的文件视图,例如表示文件的图标或文件的类型描述。- 参数
-
fileView
- 用于检索UI信息的FileView
- 另请参见:
-
getFileView()
-
getFileView
public FileView getFileView()
返回当前文件视图。- 结果
- 当前文件视图
- 另请参见:
-
setFileView(javax.swing.filechooser.FileView)
-
getName
public String getName(File f)
返回文件名。- 参数
-
f
-File
- 结果
- 该
String
包含的文件名f
- 另请参见:
-
FileView.getName(java.io.File)
-
getDescription
public String getDescription(File f)
返回文件描述。- 参数
-
f
-File
- 结果
- 该
String
包含为文件描述f
- 另请参见:
-
FileView.getDescription(java.io.File)
-
getTypeDescription
public String getTypeDescription(File f)
返回文件类型。- 参数
-
f
-File
- 结果
- 该
String
包含为文件类型描述f
- 另请参见:
-
FileView.getTypeDescription(java.io.File)
-
getIcon
public Icon getIcon(File f)
返回此文件或文件类型的图标,具体取决于系统。- 参数
-
f
-File
- 结果
-
Icon
用于此文件或文件类型 - 另请参见:
-
FileView.getIcon(java.io.File)
-
isTraversable
public boolean isTraversable(File f)
如果可以访问文件(目录),则返回true。 如果无法遍历目录,则返回false。- 参数
-
f
-File
- 结果
- 如果可以遍历文件/目录,则返回true,否则返回false
- 另请参见:
-
FileView.isTraversable(java.io.File)
-
accept
public boolean accept(File f)
如果应显示该文件,则返回true。- 参数
-
f
-File
- 结果
- 如果应该显示文件,则为true,否则为false
- 另请参见:
-
FileFilter.accept(java.io.File)
-
setFileSystemView
@BeanProperty(expert=true, description="Sets the FileSytemView used to get filesystem information.")public void setFileSystemView(FileSystemView fsv)
设置JFileChooser
用于访问和创建文件系统资源的文件系统视图,例如查找软盘驱动器和获取根驱动器列表。- 参数
-
fsv
- 新的FileSystemView
- 另请参见:
-
FileSystemView
-
getFileSystemView
public FileSystemView getFileSystemView()
返回文件系统视图。- 结果
-
FileSystemView
对象 - 另请参见:
-
setFileSystemView(javax.swing.filechooser.FileSystemView)
-
approveSelection
public void approveSelection()
当用户点击“批准”按钮时(由默认情况下标记为“打开”或“保存”),由UI调用。 这也可以由程序员调用。 此方法使用等于APPROVE_SELECTION
的命令字符串触发操作事件。- 另请参见:
-
APPROVE_SELECTION
-
cancelSelection
public void cancelSelection()
当用户选择“取消”按钮时由UI调用。 这也可以由程序员调用。 此方法使用等于CANCEL_SELECTION
的命令字符串触发操作事件。- 另请参见:
-
CANCEL_SELECTION
-
addActionListener
public void addActionListener(ActionListener l)
将ActionListener
添加到文件选择器。- 参数
-
l
- 要添加的侦听器 - 另请参见:
-
approveSelection()
,cancelSelection()
-
removeActionListener
public void removeActionListener(ActionListener l)
从文件选择器中删除ActionListener
。- 参数
-
l
- 要删除的侦听器 - 另请参见:
-
addActionListener(java.awt.event.ActionListener)
-
getActionListeners
@BeanProperty(bound=false)public ActionListener[] getActionListeners()
返回在此文件选择器上注册的所有动作侦听器的数组。- 结果
- 如果当前没有注册动作侦听器,则所有此文件选择器的
ActionListener
或空数组 - 从以下版本开始:
- 1.4
- 另请参见:
-
addActionListener(java.awt.event.ActionListener)
,removeActionListener(java.awt.event.ActionListener)
-
fireActionPerformed
protected void fireActionPerformed(String command)
通知所有已注册对此事件类型的通知感兴趣的听众。 使用command
参数延迟创建事件实例。- 参数
-
command
- 可以指定与事件关联的命令的字符串 - 另请参见:
-
EventListenerList
-
updateUI
public void updateUI()
将UI属性重置为当前外观的值。- 重写:
-
updateUI
类JComponent
- 另请参见:
-
JComponent.updateUI()
-
getUIClassID
@BeanProperty(bound=false, expert=true, description="A string that specifies the name of the L&F class.")public String getUIClassID()
返回一个字符串,该字符串指定呈现此组件的L&F类的名称。- 重写:
-
getUIClassID
类JComponent
- 结果
- 字符串“FileChooserUI”
- 另请参见:
-
JComponent.getUIClassID()
,UIDefaults.getUI(javax.swing.JComponent)
-
getUI
@BeanProperty(bound=false)public FileChooserUI getUI()
获取实现此组件的L&F的UI对象。- 重写:
-
getUI
类别JComponent
- 结果
- 实现FileChooserUI L&F的FileChooserUI对象
-
paramString
protected String paramString()
返回此JFileChooser
的字符串表示JFileChooser
。 此方法仅用于调试目的,返回字符串的内容和格式可能因实现而异。 返回的字符串可能为空,但可能不是null
。- 重写:
-
paramString
类JComponent
- 结果
- 此
JFileChooser
的字符串表示JFileChooser
-
getAccessibleContext
@BeanProperty(bound=false)public AccessibleContext getAccessibleContext()
获取与此JFileChooser关联的AccessibleContext。 对于文件选择器,AccessibleContext采用AccessibleJFileChooser的形式。 如有必要,将创建一个新的AccessibleJFileChooser实例。- Specified by:
-
getAccessibleContext
在Accessible
- 重写:
-
getAccessibleContext
类Component
- 结果
- 一个AccessibleJFileChooser,用作此JFileChooser的AccessibleContext
-
-