java.lang.Object
   |
   +--java.awt.Component
         |
         +--java.awt.Container
               |
               +--javax.swing.JComponent
                     |
                     +--javax.swing.JFileChooser

Deklaration

Beschreibung

Der folgende Code zeigt einen JFileChooser, welches im Benutzerverzeichnis nur .gif oder .jpg auswählen lässt:

 JFileChooser chooser = new JFileChooser();
 ExampleFileFilter filter = new ExampleFileFilter();
 filter.addExtension("jpg");
 filter.addExtension("gif");
 filter.setDescription("JPG & GIF Images");
 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());
 }

Methoden
protected void	setup(FileSystemView view)
public void	setDragEnabled(boolean b)
public boolean	getDragEnabled()
public File	getSelectedFile()
public void	setSelectedFile(File file)
public File[]	getSelectedFiles()
public void	setSelectedFiles(File[] selectedFiles)
public File	getCurrentDirectory()
public void	setCurrentDirectory(File dir)
public void	changeToParentDirectory()
public void	rescanCurrentDirectory()
public void	ensureFileIsVisible(File f)
public int	showOpenDialog(Component parent)
public int	showSaveDialog(Component parent)
public int	showDialog(Component parent, String approveButtonText)
protected JDialog	createDialog(Component parent)
public boolean	getControlButtonsAreShown()
public void	setControlButtonsAreShown(boolean b)
public int	getDialogType()
public void	setDialogType(int dialogType)
public void	setDialogTitle(String dialogTitle)
public String	getDialogTitle()
public void	setApproveButtonToolTipText(String toolTipText)
public String	getApproveButtonToolTipText()
public int	getApproveButtonMnemonic()
public void	setApproveButtonMnemonic(int mnemonic)
public void	setApproveButtonMnemonic(char mnemonic)
public void	setApproveButtonText(String approveButtonText)
public String	getApproveButtonText()
public FileFilter[]	getChoosableFileFilters()
public void	addChoosableFileFilter(FileFilter filter)
public boolean	removeChoosableFileFilter(FileFilter f)
public void	resetChoosableFileFilters()
public FileFilter	getAcceptAllFileFilter()
public boolean	isAcceptAllFileFilterUsed()
public void	setAcceptAllFileFilterUsed(boolean b)
public JComponent	getAccessory()
public void	setAccessory(JComponent newAccessory)
public void	setFileSelectionMode(int mode)
public int	getFileSelectionMode()
public boolean	isFileSelectionEnabled()
public boolean	isDirectorySelectionEnabled()
public void	setMultiSelectionEnabled(boolean b)
public boolean	isMultiSelectionEnabled()
public boolean	isFileHidingEnabled()
public void	setFileHidingEnabled(boolean b)
public void	setFileFilter(FileFilter filter)
public FileFilter	getFileFilter()
public void	setFileView(FileView fileView)
public FileView	getFileView()
public String	getName(File f)
public String	getDescription(File f)
public String	getTypeDescription(File f)
public Icon	getIcon(File f)
public boolean	isTraversable(File f)
public boolean	accept(File f)
public void	setFileSystemView(FileSystemView fsv)
public FileSystemView	getFileSystemView()
public void	approveSelection()
public void	cancelSelection()
public void	addActionListener(ActionListener l)
public void	removeActionListener(ActionListener l)
public ActionListener[]	getActionListeners()
protected void	fireActionPerformed(String command)
public void	updateUI()
public String	getUIClassID()
public FileChooserUI	getUI()
protected String	paramString()
public AccessibleContext	getAccessibleContext()

Datenelemente im Detail

public final static int OPEN_DIALOG

Konstante, die für den Öffnen-Dialog benutzt wird.

public final static int SAVE_DIALOG

Konstante, die für den Speichern-Dialog benutzt wird.

public final static int CUSTOM_DIALOG

Konstante, die für einen beliebigen Dialog benutzt wird.

public final static int CANCEL_OPTION

Konstante für den Rückgabewert, wenn der Benutzer den Dialog abgebrochen hat.

public final static int APPROVE_OPTION

Konstante für den Rückgabewert, wenn der Benutzer den Dialog durch den Okay-Button verlassen hat.

public final static int ERROR_OPTION

Konstante für den Rückgabewert, wenn der Dialog aufgrund eines Fehlers geschlossen wurde.

public final static int FILES_ONLY

Konstante, die aussagt, dass nur Dateien angezeigt werden dürfen.

public final static int DIRECTORIES_ONLY

Konstante, die aussagt, dass nur Verzeichnisse angezeigt werden dürfen.

public final static int FILES_AND_DIRECTORIES

Konstante, die aussagt, dass Verzeichnisse und Dateien angezeigt werden sollen.

public final static String CANCEL_SELECTION

Konstante für den Abbruch.

public final static String APPROVE_SELECTION

Konstante für die Bestätigung einer Dateiselektion.

public final static String APPROVE_BUTTON_TEXT_CHANGED_PROPERTY

Property-Name für die Änderung des Bestätigungsbuttons.

public final static String APPROVE_BUTTON_TOOL_TIP_TEXT_CHANGED_PROPERTY

Property-Name für die Änderung des Tooltips für den Bestätigungsbuttons.

public final static String APPROVE_BUTTON_MNEMONIC_CHANGED_PROPERTY

Property-Name für die Änderung des Tastenkürzels des Bestätigungsbuttons.

public final static String CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY

Property-Name für die Anzeige der Control-Buttons.

public final static String DIRECTORY_CHANGED_PROPERTY

Property-Name für die Änderung des Benutzerverzeichnisses.

public final static String SELECTED_FILE_CHANGED_PROPERTY

Property-Name für die Änderung der Dateiselektion.

public final static String SELECTED_FILES_CHANGED_PROPERTY

Property-Name für die Änderung der Dateienselektion.

public final static String MULTI_SELECTION_ENABLED_CHANGED_PROPERTY

Property-Name für die Änderung des Wertes für die Mehrfachselektion.

public final static String FILE_SYSTEM_VIEW_CHANGED_PROPERTY

Property-Name für die Änderung des FileSystemViews.

public final static String FILE_VIEW_CHANGED_PROPERTY

Property-Name für die Änderung des FileViews.

public final static String FILE_HIDING_CHANGED_PROPERTY

Property-Name für die Änderung der Anzeige der versteckten Dateien.

public final static String FILE_FILTER_CHANGED_PROPERTY

Property-Name für die Änderung des FileFilters.

public final static String FILE_SELECTION_MODE_CHANGED_PROPERTY

Property-Name für die Änderung des fileSelectionMode.

public final static String ACCESSORY_CHANGED_PROPERTY

Property-Name für die Änderung der Accessory-Komponente.

public final static String ACCEPT_ALL_FILE_FILTER_USED_CHANGED_PROPERTY

Property-Name für die Änderung des Attributes AcceptAllFileFilter.

public final static String DIALOG_TITLE_CHANGED_PROPERTY

Property-Name für die Änderung des Dialog-Titels.

public final static String DIALOG_TYPE_CHANGED_PROPERTY

Property-Name für die Änderung des Dialogtyps.

public final static String CHOOSABLE_FILE_FILTER_CHANGED_PROPERTY

Property-Name für die Änderung der choosable filter.

protected AccessibleContext accessibleContext

Konstruktoren im Detail

public JFileChooser()

Erstellt einen JFileChooser, der auf das Benutzerverzeichnis zeigt. Bei Windows ist dies beispielsweise das Verzeichnis Meine Dokumente.

public JFileChooser(String currentDirectoryPath)

Erstellt einen JFileChooser mit dem angegebenen Pfad. Wenn der Pfad null ist, wird das Benutzerverzeichnis genommen.

public JFileChooser(File currentDirectory)

Erstellt einen JFileChooser mit dem angegebenen Pfad. Wenn der Pfad null ist, wird das Benutzerverzeichnis genommen.

public JFileChooser(FileSystemView fsv)

Erstellt einen JFileChooser mit dem angegebenen FileSystemView.

public JFileChooser(File currentDirectory, FileSystemView fsv)

Erstellt einen JFileChooser mit dem angegebenen Verzeichnis und dem FileSystemView.

public JFileChooser(String currentDirectoryPath, FileSystemView fsv)

Erstellt einen JFileChooser mit dem angegebenen Verzeochnis und dem FileSystemView.

Methoden im Detail

protected void setup(FileSystemView view)

Initialisiert den JFileChooser.

public void setDragEnabled(boolean b)     

Aktiviert oder deaktiviert das Dragging bei dieser Komponente (Standard ist deaktiviert). Ein transferHandler muss gesetzt sein, wenn das Dragging funktionieren soll.

public boolean getDragEnabled()     

Liefert Auskunft darüber, ob Dragging aktiviert ist.

public File getSelectedFile()

Liefert die selektierte Datei.

public void setSelectedFile(File file)

Setzt die selektierte Datei.

public File[] getSelectedFiles()

Liefert die selektierten Dateien.

public void setSelectedFiles(File[] selectedFiles)

Setzt die Liste der selektierten Dateien, wenn der FileChooser Mehrfachselektion gestattet.

public File getCurrentDirectory()

Liefert das aktuelle Verzeichnis.

public void setCurrentDirectory(File dir)

Setzt das aktuelle Verzeichnis. Wenn stattdessen null angegeben wurde, wird das Benutzerverzeichnis (auf Windows beispielsweise das Verzeichnis Meine Dokumente) genommen.

public void changeToParentDirectory()

Ändert das aktuelle Verzeichnis auf das Oberverzeichnis.

public void rescanCurrentDirectory()

Sagt der Oberfläche, die Dateien des aktuellen Verzeichnnisses neu einzulesen.

public void ensureFileIsVisible(File f)

Stellt sicher, dass die angegebene sichtbar und nicht versteckt ist.

public int showOpenDialog(Component parent)

Zeigt den »Öffnen«-Dialog an. Der Text des Akzeptieren-Button wird dabei durch das Look-and-Feel bestimmt. Der Parameter parent kann dabei den Wert null haben.

Exception: HeadlessException

• Wenn GraphicsEnvironment.isHeadless() true liefert..

public int showSaveDialog(Component parent)

Zeigt den »Speichern«-Dialog an. Der Text des Akzeptieren-Button wird dabei durch das Look-and-Feel bestimmt. Der Parameter parent kann dabei den Wert null haben.

Exception: HeadlessException

• Wenn GraphicsEnvironment.isHeadless() true liefert..

public int showDialog(Component parent, String approveButtonText)

Zeigt einen angepassten JFileChooser mit dem angegebenen Text für den Akzeptieren-Button an. Die angegebene Komponente (kann den Wert null haben) bestimmt die Position des Dialogs.

Exception: HeadlessException

• Wenn GraphicsEnvironment.isHeadless() true liefert..

protected JDialog createDialog(Component parent)     

Erzeugt einen neuen JDialog und liefert diesen zurück, wobei dieser zentriert zur angegebenen Komponente dargestellt wird. Diese Methode kann überschrieben werden, um beispielsweise zu verhindern, dass der Dialog in der Größe verändert wird:

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;
 }
}

Exception: HeadlessException

• Wenn GraphicsEnvironment.isHeadless() true liefert..

public boolean getControlButtonsAreShown()     

Liefert true, wenn die Kontrollbuttons gezeigt werden.

public void setControlButtonsAreShown(boolean b)     

Setzt den Wert für die Anzeige der Kontrollbuttons (Akzeptieren- und Abbrechenbuttons). Der Standardwert ist true.

public int getDialogType()

Liefert den Typ des Dialoges (Standard ist ist JFileChooser.OPEN_DIALOG). Mögliche Werte sind dabei JFileChooser.OPEN_DIALOG, JFileChooser.SAVE_DIALOG und JFileChooser.CUSTOM_DIALOG.

public void setDialogType(int dialogType)

Setzt den Typ des Dialoges. Mögliche Werte sind dabei JFileChooser.OPEN_DIALOG, JFileChooser.SAVE_DIALOG und JFileChooser.CUSTOM_DIALOG.

public void setDialogTitle(String dialogTitle)

Setzt den Text für die Titelzeile des Dialoges.

public String getDialogTitle()

Liefert den Text der Titelzeile des Dialoges.

public void setApproveButtonToolTipText(String toolTipText)

Setzt den Tooltip des Akzeptieren-Buttons.

public String getApproveButtonToolTipText()

Liefert den Tooltip des Akzeptieren-Buttons.

public int getApproveButtonMnemonic()

Liefert das Tastaturkürzel des Akzeptieren-Buttons.

public void setApproveButtonMnemonic(int mnemonic)

Setzt das Tastaturkürzel des Akzeptieren-Buttons.

public void setApproveButtonMnemonic(char mnemonic)

Setzt das Tastaturkürzel des Akzeptieren-Buttons.

public void setApproveButtonText(String approveButtonText)

Setzt den Text des Akzeptieren-Buttons.

public String getApproveButtonText()

Liefert den Text des Akzeptieren-Buttons.

public FileFilter[] getChoosableFileFilters()

Liefert die benutzerauswählbaren Dateifilter.

public void addChoosableFileFilter(FileFilter filter)

Fügt einen benutzerauswählbaren Dateifilter hinzu.

public boolean removeChoosableFileFilter(FileFilter f)

Entfernt einen benutzerauswählbaren Dateifilter. Liefert true, wenn das Entfernen erfolgreich war.

public void resetChoosableFileFilters()

Setzt die benutzerauswählbaren Dateifilter zurück, so dass typischerweise nur der Alles-Akzeptieren-Filter existent ist.

public FileFilter getAcceptAllFileFilter()

Liefert den Standard Alles-Akzeptieren-Filter.

public boolean isAcceptAllFileFilterUsed()     

Liefert true, wenn der Alles-Akzeptieren-Filter benutzt wird.

public void setAcceptAllFileFilterUsed(boolean b)     

Wenn auf true gesetzt, wird der Alles-Akzeptieren-Filter benutzt. Nach der Initialisierung des JFileChoosers ist dies der einzige benutzte Filter.

public JComponent getAccessory()

Liefert die Zusatzkomponente (typischerweise eine Vorschau).

public void setAccessory(JComponent newAccessory)

Setzt die Zusatzkomponente (typischerweise eine Vorschau).

public void setFileSelectionMode(int mode)

Setzt den Selektionsmodus auf JFileChooser.FILES_ONLY (der Standard), JFileChooser.DIRECTORIES_ONLY oder JFileChooser.FILES_AND_DIRECTORIES.

public int getFileSelectionMode()

Liefert den Selektionsmodus. Die möglichen Werte sind JFileChooser.FILES_ONLY (der Standard), JFileChooser.DIRECTORIES_ONLY oder JFileChooser.FILES_AND_DIRECTORIES.

public boolean isFileSelectionEnabled()

Liefert true, wenn Dateien selektiert werden dürfen.

public boolean isDirectorySelectionEnabled()

Liefert true, wenn Verzeichnisse selektiert werden dürfen.

public void setMultiSelectionEnabled(boolean b)

Gibt an, ob Mehrfachselektion erlaubt sein soll.

public boolean isMultiSelectionEnabled()

Liefert true, wenn Mehrfachselektion erlaubt ist.

public boolean isFileHidingEnabled()

Liefert true, wenn versteckte Dateien nicht angezeigt werden.

public void setFileHidingEnabled(boolean b)

Wenn auf true gesetzt, werden versteckte Dateien nicht angezeigt.

public void setFileFilter(FileFilter filter)

Setzt den aktuellen Dateifilter. Der Filter wird benutzt um Dateien aus der Benutzeransicht herauszufiltern.

public FileFilter getFileFilter()

Liefert den zur Zeit selektierten Dateifilter.

public void setFileView(FileView fileView)

Setzt das FileView-Exemplar, dass bspw. die Icons zu den Dateien liefert.

public FileView getFileView()

Liefert das FileView-Exemplar.

public String getName(File f)

Liefert den Dateinamen gemäß des FileView-Exemplars.

public String getDescription(File f)

Liefert die Beschreibung der Datei gemäß des FileView-Exemplars.

public String getTypeDescription(File f)

Liefert den Dateityp gemäß des FileView-Exemplars.

public Icon getIcon(File f)

Liefert das Icon zur angegebenen Datei gemäß des FileView-Exemplars.

public boolean isTraversable(File f)

Liefert true, wenn das angegebene Verzeichnis begehbar ist.

public boolean accept(File f)

Liefert true, wenn die angegebene Datei angezeigt werden soll.

public void setFileSystemView(FileSystemView fsv)

Setzt das FileSystemView-Exemplar. Dieses gibt bspw. Auskunft über die Laufwerksnamen bei Windows.

public FileSystemView getFileSystemView()

Liefert das FileSystemView-Exemplar.

public void approveSelection()

Wird vom User-Interface aufgerufen, wenn der Benutzer den Akzeptieren-Button klickt. Diese Methode erzeugt einen ActionEvent mit APPROVE_SELECTION als Command-String.

public void cancelSelection()

Wird von der Oberfläche aufgerufen, wenn der Benutzer den Cancel-Button geklickt hat. Diese Methode löst ein ActionEvent mit dem actionCommand CANCEL_SELECTION aus.

public void addActionListener(ActionListener l)

Fügt einen ActionListener hinzu.

public void removeActionListener(ActionListener l)

Entfernt einen ActionListener.

public ActionListener[] getActionListeners()     

Liefert alle registrierten ActionListener.

protected void fireActionPerformed(String command)

Benachrichtigt alle registrierten ActionListener.

public void updateUI()

Reinitialisiert das UI.

public String getUIClassID()

Liefert den Namen der UI-Klasse für diese Komponente.

public FileChooserUI getUI()

Liefert das FileChooserUI.

protected String paramString()

Liefert eine String-Repräsentation dieser Komponente. Dies dient nur zum Debuggen und kann bei unterschiedlichen VMs unterschiedlich sein.

public AccessibleContext getAccessibleContext()

Liefert das AccessibleContext-Exemplar.