File Chooser

Avaa ChatGPT:ssä

Varjo 24.02

Java API

FileChooserDialog on muotodialogi, joka on suunniteltu antamaan käyttäjälle mahdollisuus valita tiedosto tai hakemisto palvelimen tiedostojärjestelmästä. Dialogi estää sovelluksen suorittamisen, kunnes käyttäjä on tehnyt valinnan tai sulkenut dialogin.

Käytöt

FileChooserDialog tarjoaa tavan valita tiedostoja tai hakemistoja tiedostojärjestelmästä, mikä mahdollistaa käyttäjien valita hakemistoja tietojen tallentamiseen tai suorittaa tiedosto-operaatioita.

Näytä koodi

Java

Tulos

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

tiedot

Palautettava merkkijono palautuu show()-metodista tai vastaavasta OptionDialog-metodista 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 mukauttaa valintatapaa erityistarpeidesi 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 sallii sinun määrittää alkuperäisen polun, johon dialogi avautuu näyttämisen yhteydessä. Tämä voi tarjota käyttäjille lähtökohdan tiedoston valintaan.

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)-metodia.

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

Suodattimet

Kun valintatila on FILES, FileChooserDialog sallii suodattimien asettamisen rajoittaaksesi lueteltavien tiedostojen tyyppejä. Voit määrittää suodattimia käyttämällä setFilters(List<FileChooserFilter> filters)-metodia.

Näytä koodi

Java

Mukautetut suodattimet

Voit antaa käyttäjille mahdollisuuden lisätä mukautettuja suodattimia sallimalla mukautettujen suodattimien ominaisuuden käyttämällä setCustomFilters(boolean customFilters)-metodia. Mukautetut suodattimet tallennetaan oletusarvoisesti selaimen paikalliseen tallennustilaan ja palautetaan, kun dialogi näytetään jälleen.

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

Kansainvälistäminen (i18n)

Komponentin otsikot, kuvaukset, merkinnät ja viestit ovat täysin mukautettavissa käyttämällä FileChooserI18n-luokkaa. Tämä joustavuus mahdollistaa dialogin käyttöliittymän mukauttamisen erityisten lokalisointivaatimusten tai henkilökohtaisten mieltymysten mukaan.

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 kehottajat: Varmista, että kehotusviesti selkeästi selittää, mitä käyttäjän on määrä valita.
2. Sopivat valintatilat: Valitse valintatiloja, jotka vastaavat vaadittua käyttäjätoimintoa varmistaaksesi tarkat ja relevantit valinnat.
3. Loogiset alkuperäiset polut: Aseta alkuperäiset polut, jotka tarjoavat käyttäjille hyödyllisen lähtökohdan valinnalleen.
4. Rajoita hakemiston navigointia: Rajoita dialogi tiettyyn hakemistoon tarpeen mukaan estääksesi käyttäjiä navigoimasta luvattomiin alueisiin.