File Save

Avaa ChatGPT:ssä

Varjo 24.21

Java API

FileSaveDialog on modaalinen dialogi, joka on suunniteltu sallimaan käyttäjien tallentaa tiedosto määritettyyn sijaintiin palvelimen tiedostojärjestelmässä. Dialogi estää sovelluksen suorittamisen, kunnes käyttäjä antaa tiedostonimen ja vahvistaa toiminnan tai peruuttaa dialogin.

Käyttötarkoitukset

FileSaveDialog tarjoaa sujuvan tavan tallentaa tiedostoja tiedostojärjestelmään, tarjoten käyttäjän määritettäviä vaihtoehtoja tiedostojen nimeämiseksi ja olemassa olevien tiedostojen käsittelemiseksi.

Näytä koodi

Java

Tulokset

FileSaveDialog palauttaa valitun polun merkkijonona. Jos käyttäjä peruuttaa dialogin, paluuarvo on null.

Dialogin tarkoitus

Tämä dialogi ei itse asiassa tallenna tiedostoja, vaan palauttaa käyttäjän valitsemat tiedostonumerot.

tiedot

Palautettu merkkijono saadaan show()-metodista tai vastaavasta OptionDialog-metodista, kuten alla on esitetty.

String result = OptionDialog.showFileSaveDialog(
    "Tallenna tiedostosi", "/home/user/documents", "report.xls");

if (result != null) {
  OptionDialog.showMessageDialog("Tiedosto tallennettu: " + path, "Valittu polku");
} else {
  OptionDialog.showMessageDialog("Ei polkua ole valittu", "Valittu polku",
      MessageDialog.MessageType.ERROR);
}

Olemassa oleva toiminto

FileSaveDialog tarjoaa säädettävän käyttäytymisen, kun tiedosto, jolla on määrätty nimi, on jo olemassa:

• ACCEPT_WITHOUT_ACTION: Valinta hyväksytään ilman lisätoimia käyttäjältä.
• ERROR_DIALOGUE: Käyttäjälle esitetään virhedialogi; valintaa ei sallita.
• CONFIRMATION_DIALOGUE: Käyttäjälle esitetään dialogi, jossa pyydetään vahvistusta. Tämä on oletus.

FileSaveDialog dialog = new FileSaveDialog(
  "Tallenna tiedostosi", "/home/user/documents", "report.xls");
dialog.setExistsAction(FileSaveDialog.ExistsAction.ERROR_DIALOGUE);
String result = dialog.show();

Valintatapa

FileSaveDialog tukee erilaisia valintatapoja, jolloin voit räätälöidä valintamenetelmän tarpeidesi mukaan:

1. TIEDOSTOT: Sallii vain tiedostojen valinnan.
2. HAKEMISTOT: Sallii vain hakemiston valinnan.
3. TIEDOSTOT_JA_HAKEMISTOT: Sallii sekä tiedostojen että hakemistojen valinnan.

Alkuperäinen polku

Määritä hakemisto, josta dialogi avautuu alkuperäisellä polulla. Tämä auttaa käyttäjiä aloittamaan järkevästä hakemistosta tallennustoiminnolle.

FileSaveDialog dialog = new FileSaveDialog(
  "Tallenna tiedostosi", "/home/user/documents", "report.xls");
String result = dialog.show();

Rajoitus

Voit rajoittaa dialogin tiettyyn hakemistoon estäen käyttäjiä siirtymästä sen ulkopuolelle käyttämällä setRestricted(boolean restricted)-metodia.

FileSaveDialog dialog = new FileSaveDialog(
  "Tallenna tiedostosi", "/home/user/documents", "report.xls");
dialog.setRestricted(true);
dialog.show();

Tiedostonimi

Aseta oletustiedostonimi tallennustoimenpiteelle, jotta voit opastaa käyttäjiä ja minimoida virheitä.

FileSaveDialog dialog = new FileSaveDialog("Tallenna tiedostosi");
dialog.setName("report.xls");
String result = dialog.show();

Kansainvälistäminen (i18n)

Komponentin otsikot, kuvaukset, merkinnät ja viestit ovat täysin mukautettavissa käyttämällä FileSaveI18n-luokkaa. Tämä varmistaa, että dialogi voidaan räätälöidä eri lokalisointi- tai personointitarpeisiin.

FileSaveDialog dialog = new FileSaveDialog("Tallenna tiedostosi");
FileChooserI18n i18n = new FileChooserI18n();
i18n.setChoose("Valitse");
i18n.setCancel("Peruuta");
dialog.setI18n(i18n);

Suodattimet

FileSaveDialog sallii suodattimien asettamisen tiedostotyyppien rajoittamiseksi, jotka voidaan tallentaa käyttämällä setFilters(List<FileSaveFilter> filters)-metodia.

Näytä koodi

Java

Mukautetut suodattimet

Voit mahdollistaa mukautetut suodattimet, jotka sallivat käyttäjien määrittää omia tiedostosuodattimia käyttämällä setCustomFilters(boolean customFilters)-metodia. Suodattimet tallennetaan oletuksena paikalliseen tallennustilaan ja palautetaan seuraavissa dialogien kutsuissa.

FileSaveDialog dialog = new FileSaveDialog("Tallenna tiedostosi", "/home/user/documents");
dialog.setCustomFilters(true);
String result = dialog.show();

Parhaat käytännöt

• Ennalta määritellyt tiedostonimet: Tarjoa järkevä oletustiedostonimi, kun se on mahdollista.
• Vahvista ylikirjoitukset: Käytä CONFIRMATION_DIALOGUE-asetusta ExistsAction-toiminnossa estämään vahingossa tapahtuvat ylikirjoitukset.
• Intuitiivinen alkuperäinen polku: Aseta alkuperäinen polku, joka vastaa käyttäjien odotuksia.
• Kansainvälistäminen: Mukauta dialogin tekstiä käytettävyyden parantamiseksi kansainvälisille käyttäjille.
• Tiedostotyypin suodattimet: Hyödynnä suodattimia rajoittaaksesi tiedostotyyppejä ja ohjataksesi käyttäjiä kohti voimassa olevia tiedostopäätteitä.