Tallenna tiedosto -valintaikkuna

Avaa ChatGPT:ssä

Shadow 24.21

Java API

FileSaveDialog on modaalinen valintaikkuna, joka on suunniteltu mahdollistamaan käyttäjien tiedoston tallentaminen tiettyyn sijaintiin palvelimen tiedostojärjestelmässä. Ikkuna estää sovelluksen suorituksen, kunnes käyttäjä antaa tiedostonimen ja vahvistaa toiminnon tai peruuttaa ikkunan.

OptionDialog.showFileSaveDialog("Tallenna tiedostosi");

Käyttöesimerkit

FileSaveDialog tarjoaa virtaviivaisen menetelmän tiedostojen tallentamiseen tiedostojärjestelmään, tarjoten käyttäjän määriteltäviä vaihtoehtoja tiedoston nimeämiseen ja olemassa olevien tiedostojen käsittelyyn.

Näytä Koodi

Java

Tulokset

FileSaveDialog palauttaa valitun polun merkkijonona. Jos käyttäjä peruuttaa valintaikkunan, tulos on null.

Valintaikkunan tarkoitus

Tämä valintaikkuna ei oikeastaan tallenna tiedostoja, vaan palauttaa sen tiedostonimen, jonka käyttäjä on valinnut.

tiedot

Tuloksena oleva merkkijono palautuu show()-menetelmällä tai vastaavalla OptionDialog-menetelmällä kuten alla osoitetaan.

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

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

Olemassa olevat toiminnot

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

• ACCEPT_WITHOUT_ACTION: Valinta hyväksytään ilman lisätoimia käyttäjältä.
• ERROR_DIALOGUE: Käyttäjälle näytetään virheilmoitusikkuna; valintaa ei sallita.
• CONFIRMATION_DIALOGUE: Käyttäjälle näytetään ikkuna, joka pyytää vahvistusta. Tämä on oletus.

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

Valintatila

FileSaveDialog tukee erilaisia valintatiloja, jolloin voit mukauttaa valintatavan tarpeidesi mukaan:

1. FILES: Mahdollistaa vain tiedostojen valitsemisen.
2. DIRECTORIES: Mahdollistaa vain kansioiden valitsemisen.
3. FILES_AND_DIRECTORIES: Mahdollistaa sekä tiedostojen että kansioiden valitsemisen.

Alustava polku

Määritä hakemisto, jossa valintaikkuna avataan käyttämällä alustavaa polkua. Tämä auttaa käyttäjiä aloittamaan loogisessa hakemistossa tallennustoimintoa varten.

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

Rajoitus

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

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

Tiedostonimi

Aseta oletustiedostonimi tallennusoperaatiota varten ohjataksesi käyttäjiä ja minimoidaksesi virheitä.

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

Kansainvälistäminen (i18n)

Komponentin sisällä olevat otsikot, kuvaukset, etiketit ja viestit ovat täysin mukautettavissa käyttämällä FileSaveI18n-luokkaa. Tämä varmistaa, että valintaikkuna voidaan muokata erilaisten lokalisaatio- tai personointivaatimusten mukaan.

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

Suodattimet

FileSaveDialog mahdollistaa suodattimien asettamisen, jotta voidaan rajoittaa tallennettavien tiedostotyyppien valikoimaa käyttämällä setFilters(List<FileSaveFilter> filters) -menetelmää.

Näytä Koodi

Java

Mukautetut suodattimet

Voit mahdollistaa mukautetut suodattimet, jotta käyttäjät voivat määrittää omat tiedostosarjansa käyttämällä setCustomFilters(boolean customFilters) -menetelmää. Suodattimet tallennetaan paikalliseen tallennustilaan oletuksena ja palautetaan seuraavilla valintaikkunan avauksilla.

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

Parhaat käytännöt

• Ennakoidut tiedostonimet: Tarjoa looginen oletustiedostonimi, missä se on soveltuva.
• Vahvista ylittämiset: Käytä CONFIRMATION_DIALOGUE-valintaa ExistsAction:in osalta estämään tahattomia ylityksiä.
• Intuitiivinen alustava polku: Aseta alustava polku, joka vastaa käyttäjän odotuksia.
• Kansainvälistäminen: Mukauta valintaikkunan tekstiä käytettävyyden parantamiseksi kansainvälisille käyttäjille.
• Tiedostotyyppisuodattimet: Hyödynnä suodattimia rajoittamaan tiedostotyyppejä ja ohjaamaan käyttäjiä kohti kelvollisia tiedostopäätteen.