File Chooser

Avaa ChatGPT:ssä

Varjo 24.02

Java API

FileChooserDialog on modaalinen dialogi, joka on suunniteltu antamaan käyttäjälle mahdollisuus valita tiedosto tai hakemisto palvelimen tiedostojärjestelmästä. Dialogi estää sovelluksen toiminnan, kunnes käyttäjä tekee valinnan tai sulkee dialogin.

Käytännöt

FileChooserDialog tarjoaa tavan valita tiedostoja tai hakemistoja tiedostojärjestelmästä, jolloin käyttäjät voivat valita hakemistoja tietojen tallentamista varten tai suorittaa tiedostotoimintoja.

Näytä koodi

FileChooserDialogBasicView.java

Tulosta

FileChooserDialog palauttaa valitun tiedoston tai hakemiston merkkijonona. Jos käyttäjä sulkee dialogin ilman, että hän tekee valintaa, tulos on null.

tiedot

Palautettava merkkijono palautetaan show() -menetelmästä tai vastaavasta OptionDialog-menetelmästä, kuten alla on esitetty.

String result = OptionDialog.showFileChooserDialog(
  "Valitse tiedosto", "/home/user", FileChooserDialog.SelectionMode.FILES);

if (result != null) {
  OptionDialog.showMessageDialog("Valitsit: " + result, "Valinta tehty");
} else {
  OptionDialog.showMessageDialog("Ei valintaa tehty", "Valinta peruutettu");
}

Valintatila

FileChooserDialog tukee erilaisia valintatiloja, jolloin voit räätälöidä valintamenetelmää omien tarpeidesi mukaan:

1. FILES: Sallii vain tiedostojen valinnan.
2. DIRECTORIES: Sallii vain hakemistojen valinnan.
3. FILES_AND_DIRECTORIES: Sallii sekä tiedostojen että hakemistojen valinnan.

Alkuperäinen polku

FileChooserDialog mahdollistaa alkuperäisen polun määrittämisen, johon dialogi avautuu esitettaessä. Tämä voi antaa käyttäjille lähtöpisteen tiedostovalinnalle.

FileChooserDialog dialog = new FileChooserDialog("Valitse tiedosto", "/home/user");
String result = dialog.show();

Rajoitus

Voit rajoittaa dialogia tiettyyn hakemistoon, estäen käyttäjiä navigoimasta sen ulkopuolelle käyttämällä setRestricted(boolean restricted)-menetelmää.

FileChooserDialog dialog = new FileChooserDialog("Valitse tiedosto", "/home/user");
dialog.setRestricted(true);
dialog.show();

Suodattimet

Kun valintatila on FILES, FileChooserDialog mahdollistaa suodattimien asettamisen tiedostojen rajoittamiseksi. Voit määrittää suodattimia käyttämällä setFilters(List<FileChooserFilter> filters)-menetelmää.

Näytä koodi

FileChooserDialogFiltersView.java

Mukautetut suodattimet

Voit sallia käyttäjien lisätä mukautettuja suodattimia mahdollistamalla mukautetut suodattimet -ominaisuuden käyttäen setCustomFilters(boolean customFilters)-menetelmää. Mukautetut suodattimet tallennetaan oletuksena selaimen paikalliseen tallennustilaan ja palautetaan, kun dialogi näytetään uudelleen.

FileChooserDialog dialog = new FileChooserDialog("Valitse tiedosto", "/home/user");
dialog.setCustomFilters(true);
String result = dialog.show();

Kansainvälistaminen (i18n)

Komponentin otsikot, kuvaukset, etiketit ja viestit ovat täysin määritettävissä FileChooserI18n-luokan avulla. Tämä joustavuus mahdollistaa dialogin käyttöliittymän räätälöimisen erityisten paikallistamisvaatimusten tai personointisääntöjen mukaiseksi.

FileChooserDialog dialog = new FileChooserDialog("Valitse tiedosto", "/Users/habof/bbx");
FileChooserI18n i18n = new FileChooserI18n();
i18n.setChoose("Valitse");
i18n.setCancel("Peruuta");
dialog.setI18n(i18n);

Parhaat käytännöt

1. Selkeät ja ytimekkäät kehotteet: Varmista, että kehotteessa on selkeästi kerrottu, mitä käyttäjältä pyydetään valitsemaan.
2. Sopivat valintatilat: Valitse valintatilat, jotka vastaavat vaadittua käyttäjätoimintoa varmistaaksesi tarkat ja asiaankuuluvat valinnat.
3. Loogiset alkuperäiset polut: Aseta alkuperäiset polut, jotka tarjoavat käyttäjille hyödyllisen lähtöpisteen valinnalle.
4. Rajoita hakemiston navigointia: Rajoita dialogia tiettyyn hakemistoon, kun se on tarpeen, estääksesi käyttäjiä navigoimasta valtuuttamattomilla alueilla.