Zum Hauptinhalt springen

File Chooser

In ChatGPT öffnen
Schatten 24.02
Java API

FileChooserDialog ist ein modales Dialogfeld, das es dem Benutzer ermöglicht, eine Datei oder ein Verzeichnis aus dem Serverdateisystem auszuwählen. Der Dialog blockiert die Ausführung der Anwendung, bis der Benutzer eine Auswahl trifft oder den Dialog schließt.

Anwendungen​

Der FileChooserDialog bietet eine Möglichkeit, Dateien oder Verzeichnisse aus dem Dateisystem auszuwählen, sodass Benutzer Verzeichnisse zum Speichern von Daten auswählen oder Dateioperationen durchführen können.

Code anzeigen

Ergebnis​

Der FileChooserDialog gibt die ausgewählte Datei oder das ausgewählte Verzeichnis als String zurück. Wenn der Benutzer den Dialog schließt, ohne eine Auswahl zu treffen, ist das Ergebnis null.

Info

Der resultierende String wird von der Methode show() oder der entsprechenden OptionDialog-Methode wie unten gezeigt zurückgegeben.

String result = OptionDialog.showFileChooserDialog(
  "Wählen Sie eine Datei aus", "/home/user", FileChooserDialog.SelectionMode.FILES);

if (result != null) {
  OptionDialog.showMessageDialog("Sie haben ausgewählt: " + result, "Auswahl getroffen");
} else {
  OptionDialog.showMessageDialog("Keine Auswahl getroffen", "Auswahl abgebrochen");
}

Auswahlmodus​

Der FileChooserDialog unterstützt verschiedene Auswahlmodi, die es Ihnen ermöglichen, die Auswahlmethode an Ihre spezifischen Bedürfnisse anzupassen:

  1. FILES: Ermöglicht die Auswahl von Dateien.
  2. DIRECTORIES: Ermöglicht die Auswahl von Verzeichnissen.
  3. FILES_AND_DIRECTORIES: Ermöglicht die Auswahl von sowohl Dateien als auch Verzeichnissen.

Anfangspfad​

Der FileChooserDialog ermöglicht Ihnen, einen Anfangspfad anzugeben, zu dem der Dialog beim Anzeigen geöffnet wird. Dies kann den Benutzern einen Ausgangspunkt für ihre Dateiauswahl bieten.

FileChooserDialog dialog = new FileChooserDialog("Wählen Sie eine Datei aus", "/home/user");
String result = dialog.show();

Einschränkung​

Sie können den Dialog auf ein bestimmtes Verzeichnis einschränken, wodurch Benutzer daran gehindert werden, außerhalb davon zu navigieren, indem Sie die Methode setRestricted(boolean restricted) verwenden.

FileChooserDialog dialog = new FileChooserDialog("Wählen Sie eine Datei aus", "/home/user");
dialog.setRestricted(true);
dialog.show();

Filter​

Wenn der Auswahlmodus auf FILES eingestellt ist, ermöglicht der FileChooserDialog Ihnen, Filter festzulegen, um die aufgeführten Dateitypen zu begrenzen. Sie können Filter mithilfe der Methode setFilters(List<FileChooserFilter> filters) konfigurieren.

Code anzeigen

Benutzerdefinierte Filter​

Sie können Benutzern erlauben, benutzerdefinierte Filter hinzuzufügen, indem Sie die Funktion für benutzerdefinierte Filter mit der Methode setCustomFilters(boolean customFilters) aktivieren. Benutzerdefinierte Filter werden standardmäßig im lokalen Speicher des Browsers gespeichert und beim erneuten Anzeigen des Dialogs wiederhergestellt.

FileChooserDialog dialog = new FileChooserDialog("Wählen Sie eine Datei aus", "/home/user");
dialog.setCustomFilters(true);
String result = dialog.show();

Internationalisierung (i18n)​

Die Titel, Beschreibungen, Labels und Nachrichten innerhalb des Komponentes sind vollständig anpassbar mit der Klasse FileChooserI18n. Diese Flexibilität ermöglicht es Ihnen, die Benutzeroberfläche des Dialogs an spezifische Lokalisierungsanforderungen oder Personalisierungsvorlieben anzupassen.

FileChooserDialog dialog = new FileChooserDialog("Wählen Sie eine Datei aus", "/Users/habof/bbx");
FileChooserI18n i18n = new FileChooserI18n();
i18n.setChoose("Wählen");
i18n.setCancel("Abbrechen");
dialog.setI18n(i18n);

Beste Praktiken​

  1. Klare und prägnante Aufforderungen: Stellen Sie sicher, dass die Aufforderungsnachricht klar erklärt, was der Benutzer auswählen soll.
  2. Angemessene Auswahlmodi: Wählen Sie Auswahlmodi, die der erforderlichen Benutzeraktion entsprechen, um genaue und relevante Auswahl zu gewährleisten.
  3. Logische Anfangspfade: Setzen Sie Anfangspfade, die den Benutzern einen nützlichen Ausgangspunkt für ihre Auswahl bieten.
  4. Einschränkung der Verzeichnisnavigation: Beschränken Sie den Dialog auf ein bestimmtes Verzeichnis, wenn notwendig, um zu verhindern, dass Benutzer in nicht autorisierte Bereiche navigieren.