Weitere aktuelle Java-Titel finden Sie bei dpunkt.
 Inhaltsverzeichnis   Vorhergehendes Paket   Seite Zurück   Seite Vor   Nächstes Paket   Paketübersicht   Index

Klasse javax.swing.JFileChooser1.2

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

Deklaration

public class JFileChooser
extends javax.swing.JComponent
implements javax.accessibility.Accessible

Beschreibung

Ein JFileChooser dient dazu, Dateien vom Benutzer auswählen zu lassen.

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


 
Datenelemente
public final static intOPEN_DIALOG
public final static intSAVE_DIALOG
public final static intCUSTOM_DIALOG
public final static intCANCEL_OPTION
public final static intAPPROVE_OPTION
public final static intERROR_OPTION
public final static intFILES_ONLY
public final static intDIRECTORIES_ONLY
public final static intFILES_AND_DIRECTORIES
public final static StringCANCEL_SELECTION
public final static StringAPPROVE_SELECTION
public final static StringAPPROVE_BUTTON_TEXT_CHANGED_PROPERTY
public final static StringAPPROVE_BUTTON_TOOL_TIP_TEXT_CHANGED_PROPERTY
public final static StringAPPROVE_BUTTON_MNEMONIC_CHANGED_PROPERTY
public final static StringCONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY
public final static StringDIRECTORY_CHANGED_PROPERTY
public final static StringSELECTED_FILE_CHANGED_PROPERTY
public final static StringSELECTED_FILES_CHANGED_PROPERTY
public final static StringMULTI_SELECTION_ENABLED_CHANGED_PROPERTY
public final static StringFILE_SYSTEM_VIEW_CHANGED_PROPERTY
public final static StringFILE_VIEW_CHANGED_PROPERTY
public final static StringFILE_HIDING_CHANGED_PROPERTY
public final static StringFILE_FILTER_CHANGED_PROPERTY
public final static StringFILE_SELECTION_MODE_CHANGED_PROPERTY
public final static StringACCESSORY_CHANGED_PROPERTY
public final static StringACCEPT_ALL_FILE_FILTER_USED_CHANGED_PROPERTY
public final static StringDIALOG_TITLE_CHANGED_PROPERTY
public final static StringDIALOG_TYPE_CHANGED_PROPERTY
public final static StringCHOOSABLE_FILE_FILTER_CHANGED_PROPERTY
protected AccessibleContextaccessibleContext
 
Konstruktoren
publicJFileChooser()
publicJFileChooser(String currentDirectoryPath)
publicJFileChooser(File currentDirectory)
publicJFileChooser(FileSystemView fsv)
publicJFileChooser(File currentDirectory, FileSystemView fsv)
publicJFileChooser(String currentDirectoryPath, FileSystemView fsv)
 
Methoden
protected voidsetup(FileSystemView view)
public voidsetDragEnabled(boolean b)     [1.4]
public booleangetDragEnabled()     [1.4]
public FilegetSelectedFile()
public voidsetSelectedFile(File file)
public File[]getSelectedFiles()
public voidsetSelectedFiles(File[] selectedFiles)
public FilegetCurrentDirectory()
public voidsetCurrentDirectory(File dir)
public voidchangeToParentDirectory()
public voidrescanCurrentDirectory()
public voidensureFileIsVisible(File f)
public intshowOpenDialog(Component parent)
public intshowSaveDialog(Component parent)
public intshowDialog(Component parent, String approveButtonText)
protected JDialogcreateDialog(Component parent)     [1.4]
public booleangetControlButtonsAreShown()     [1.3]
public voidsetControlButtonsAreShown(boolean b)     [1.3]
public intgetDialogType()
public voidsetDialogType(int dialogType)
public voidsetDialogTitle(String dialogTitle)
public StringgetDialogTitle()
public voidsetApproveButtonToolTipText(String toolTipText)
public StringgetApproveButtonToolTipText()
public intgetApproveButtonMnemonic()
public voidsetApproveButtonMnemonic(int mnemonic)
public voidsetApproveButtonMnemonic(char mnemonic)
public voidsetApproveButtonText(String approveButtonText)
public StringgetApproveButtonText()
public FileFilter[]getChoosableFileFilters()
public voidaddChoosableFileFilter(FileFilter filter)
public booleanremoveChoosableFileFilter(FileFilter f)
public voidresetChoosableFileFilters()
public FileFiltergetAcceptAllFileFilter()
public booleanisAcceptAllFileFilterUsed()     [1.3]
public voidsetAcceptAllFileFilterUsed(boolean b)     [1.3]
public JComponentgetAccessory()
public voidsetAccessory(JComponent newAccessory)
public voidsetFileSelectionMode(int mode)
public intgetFileSelectionMode()
public booleanisFileSelectionEnabled()
public booleanisDirectorySelectionEnabled()
public voidsetMultiSelectionEnabled(boolean b)
public booleanisMultiSelectionEnabled()
public booleanisFileHidingEnabled()
public voidsetFileHidingEnabled(boolean b)
public voidsetFileFilter(FileFilter filter)
public FileFiltergetFileFilter()
public voidsetFileView(FileView fileView)
public FileViewgetFileView()
public StringgetName(File f)
public StringgetDescription(File f)
public StringgetTypeDescription(File f)
public IcongetIcon(File f)
public booleanisTraversable(File f)
public booleanaccept(File f)
public voidsetFileSystemView(FileSystemView fsv)
public FileSystemViewgetFileSystemView()
public voidapproveSelection()
public voidcancelSelection()
public voidaddActionListener(ActionListener l)
public voidremoveActionListener(ActionListener l)
public ActionListener[]getActionListeners()     [1.4]
protected voidfireActionPerformed(String command)
public voidupdateUI()
public StringgetUIClassID()
public FileChooserUIgetUI()
protected StringparamString()
public AccessibleContextgetAccessibleContext()


 

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)     [1.4]
Aktiviert oder deaktiviert das Dragging bei dieser Komponente (Standard ist deaktiviert). Ein transferHandler muss gesetzt sein, wenn das Dragging funktionieren soll.
public boolean getDragEnabled()     [1.4]
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
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
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
protected JDialog createDialog(Component parent)     [1.4]
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
public boolean getControlButtonsAreShown()     [1.3]
Liefert true, wenn die Kontrollbuttons gezeigt werden.
public void setControlButtonsAreShown(boolean b)     [1.3]
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()     [1.3]
Liefert true, wenn der Alles-Akzeptieren-Filter benutzt wird.
public void setAcceptAllFileFilterUsed(boolean b)     [1.3]
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()     [1.4]
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.


 Inhaltsverzeichnis   Vorhergehendes Paket   Seite Zurück   Seite Vor   Nächstes Paket   Paketübersicht   Index

Copyright © 2002 dpunkt.Verlag, Heidelberg. Alle Rechte vorbehalten.