Overslaan naar hoofdinhoud

File Chooser

Openen in ChatGPT
Schaduw 24.02
Java API

FileChooserDialog is een gemodelleerde dialoog die is ontworpen om de gebruiker in staat te stellen een bestand of een map te selecteren uit het serversysteem. De dialoog blokkeert de uitvoering van de applicatie totdat de gebruiker een selectie maakt of de dialoog sluit.

Usages​

De FileChooserDialog biedt een manier om bestanden of mappen van het bestandssysteem te selecteren, zodat gebruikers mappen kunnen kiezen voor het opslaan van gegevens, of besturingshandelingen kunnen uitvoeren.

Toon Code

Result​

De FileChooserDialog retourneert het geselecteerde bestand of de geselecteerde map als een string. Als de gebruiker de dialoog sluit zonder een selectie te maken, zal het resultaat null zijn.

info

De resulterende string zal worden geretourneerd vanuit de show()-methode, of de equivalente OptionDialog-methode zoals hieronder weergegeven.

String result = OptionDialog.showFileChooserDialog(
  "Selecteer een bestand", "/home/user", FileChooserDialog.SelectionMode.FILES);

if (result != null) {
  OptionDialog.showMessageDialog("U heeft geselecteerd: " + result, "Selectie gemaakt");
} else {
  OptionDialog.showMessageDialog("Geen selectie gemaakt", "Selectie geannuleerd");
}

Selection mode​

De FileChooserDialog ondersteunt verschillende selectie-modus, zodat je de selectiemethode kunt afstemmen op je specifieke behoeften:

  1. FILES: Stelt de selectie van alleen bestanden toe.
  2. DIRECTORIES: Stelt de selectie van alleen mappen toe.
  3. FILES_AND_DIRECTORIES: Stelt de selectie van zowel bestanden als mappen toe.

Initial path​

De FileChooserDialog stelt je in staat een initiële map op te geven waar de dialoog naar opent wanneer deze wordt weergegeven. Dit kan gebruikers een uitgangspunt bieden voor hun bestandselectie.

FileChooserDialog dialog = new FileChooserDialog("Selecteer een bestand", "/home/user");
String result = dialog.show();

Restriction​

Je kunt de dialoog beperken tot een specifieke map, zodat gebruikers niet buiten deze map kunnen navigeren met behulp van de setRestricted(boolean restricted)-methode.

FileChooserDialog dialog = new FileChooserDialog("Selecteer een bestand", "/home/user");
dialog.setRestricted(true);
dialog.show();

Filters​

Wanneer de selectiemodus FILES is, staat de FileChooserDialog je toe om filters in te stellen om de soorten bestanden te beperken die worden weergegeven. Je kunt filters configureren met de setFilters(List<FileChooserFilter> filters)-methode.

Toon Code

Custom filters​

Je kunt gebruikers toestaan om aangepaste filters toe te voegen door de functie voor aangepaste filters in te schakelen met de setCustomFilters(boolean customFilters)-methode. Aangepaste filters worden standaard opgeslagen in de lokale opslag van de browser en hersteld wanneer de dialoog opnieuw wordt weergegeven.

FileChooserDialog dialog = new FileChooserDialog("Selecteer een bestand", "/home/user");
dialog.setCustomFilters(true);
String result = dialog.show();

Internationalization (i18n)​

De titels, beschrijvingen, labels en berichten binnen de component zijn volledig aanpasbaar met behulp van de FileChooserI18n-klasse. Deze flexibiliteit stelt je in staat om de dialooginterface aan te passen om te voldoen aan specifieke lokalisatievereisten of persoonlijke voorkeuren.

FileChooserDialog dialog = new FileChooserDialog("Selecteer een bestand", "/Users/habof/bbx");
FileChooserI18n i18n = new FileChooserI18n();
i18n.setChoose("Kies");
i18n.setCancel("Annuleren");
dialog.setI18n(i18n);

Best practices​

  1. Duidelijke en beknopte prompts: Zorg ervoor dat het promptbericht duidelijk uitlegt wat de gebruiker wordt gevraagd te selecteren.
  2. Geschikte selectiemodi: Kies selectiemodi die overeenkomen met de vereiste actie van de gebruiker om nauwkeurige en relevante selecties te garanderen.
  3. Logische initiële paden: Stel initiële paden in die gebruikers een nuttig uitgangspunt bieden voor hun selectie.
  4. Beperk navigatie in mappen: Beperk de dialoog tot een specifieke map wanneer dat nodig is om te voorkomen dat gebruikers naar ongeautoriseerde gebieden navigeren.