File Save

In ChatGPT öffnen

Schatten 24.21

Java API

FileSaveDialog ist ein modales Dialogfeld, das Benutzern die Möglichkeit bietet, eine Datei an einem bestimmten Ort im Dateisystem des Servers zu speichern. Der Dialog blockiert die Ausführung der Anwendung, bis der Benutzer einen Dateiname angibt und die Aktion bestätigt oder den Dialog abbricht.

Verwendungszwecke

Das FileSaveDialog bietet eine unkomplizierte Methode zum Speichern von Dateien im Dateisystem und bietet benutzerkonfigurierte Optionen für die Benennung von Dateien und den Umgang mit vorhandenen Dateien.

Code anzeigen

Java

Ergebnis

Das FileSaveDialog gibt den ausgewählten Pfad als String zurück. Wenn der Benutzer den Dialog abbricht, wird das Ergebnis null sein.

Zweck des Dialogs

Dieser Dialog speichert tatsächlich keine Dateien, sondern gibt den vom Benutzer ausgewählten Dateinamen zurück.

Info

Der resultierende String wird aus der Methode show() oder der entsprechenden Methode von OptionDialog zurückgegeben, wie unten gezeigt.

String result = OptionDialog.showFileSaveDialog(
    "Speichern Sie Ihre Datei", "/home/user/documents", "bericht.xls");

if (result != null) {
  OptionDialog.showMessageDialog("Datei gespeichert unter: " + path, "Ausgewählter Pfad");
} else {
  OptionDialog.showMessageDialog("Kein Pfad ausgewählt", "Ausgewählter Pfad",
      MessageDialog.MessageType.ERROR);
}

Exists-Aktion

Das FileSaveDialog bietet konfigurierbares Verhalten, wenn eine Datei mit dem angegebenen Namen bereits existiert:

• ACCEPT_WITHOUT_ACTION: Die Auswahl wird akzeptiert, ohne dass der Benutzer weitere Aktionen durchführen muss.
• ERROR_DIALOGUE: Der Benutzer erhält ein Fehlerdialogfeld; die Auswahl ist nicht erlaubt.
• CONFIRMATION_DIALOGUE: Der Benutzer erhält ein Dialogfeld, das um Bestätigung bittet. Dies ist die Standardeinstellung.

FileSaveDialog dialog = new FileSaveDialog(
  "Speichern Sie Ihre Datei", "/home/user/documents", "bericht.xls");
dialog.setExistsAction(FileSaveDialog.ExistsAction.ERROR_DIALOGUE);
String result = dialog.show();

Auswahlmodus

Das FileSaveDialog unterstützt verschiedene Auswahlmodi, die es Ihnen ermöglichen, die Auswahlmethode an Ihre spezifischen Bedürfnisse anzupassen:

1. DATEIEN: Erlaubt die Auswahl von Dateien.
2. VERZEICHNISSE: Erlaubt die Auswahl von Verzeichnissen.
3. DATEIEN UND VERZEICHNISSE: Erlaubt die Auswahl von sowohl Dateien als auch Verzeichnissen.

Anfangspfad

Geben Sie das Verzeichnis an, in dem der Dialog geöffnet wird, und helfen Sie Benutzern, mit einer sinnvollen Verzeichnisstruktur für ihren Speicherbetrieb zu beginnen.

FileSaveDialog dialog = new FileSaveDialog(
  "Speichern Sie Ihre Datei", "/home/user/documents", "bericht.xls");
String result = dialog.show();

Einschränkung

Sie können den Dialog auf ein bestimmtes Verzeichnis beschränken, um zu verhindern, dass Benutzer außerhalb navigieren, indem Sie die Methode setRestricted(boolean restricted) verwenden.

FileSaveDialog dialog = new FileSaveDialog(
  "Speichern Sie Ihre Datei", "/home/user/documents", "bericht.xls");
dialog.setRestricted(true);
dialog.show();

Dateiname

Setzen Sie einen Standarddateinamen für den Speicherbetrieb, um Benutzern zu helfen und Fehler zu minimieren.

FileSaveDialog dialog = new FileSaveDialog("Speichern Sie Ihre Datei");
dialog.setName("bericht.xls");
String result = dialog.show();

Internationalisierung (i18n)

Die Titel, Beschreibungen, Labels und Nachrichten innerhalb der Komponente sind vollständig anpassbar über die Klasse FileSaveI18n. Dies stellt sicher, dass der Dialog an verschiedene Lokalisierungs- oder Personalisierungsanforderungen angepasst werden kann.

FileSaveDialog dialog = new FileSaveDialog("Speichern Sie Ihre Datei");
FileChooserI18n i18n = new FileChooserI18n();
i18n.setChoose("Wählen");
i18n.setCancel("Abbrechen");
dialog.setI18n(i18n);

Filter

Das FileSaveDialog ermöglicht es Ihnen, Filter festzulegen, um die Arten von Dateien zu begrenzen, die gespeichert werden können, über die Methode setFilters(List<FileSaveFilter> filters).

Code anzeigen

Java

Benutzerdefinierte Filter

Sie können benutzerdefinierte Filter aktivieren, um Benutzern zu ermöglichen, ihre eigenen Datei-Filter über die Methode setCustomFilters(boolean customFilters) zu definieren. Filter werden standardmäßig im lokalen Speicher gespeichert und bei nachfolgenden Aufrufen des Dialogs wiederhergestellt.

FileSaveDialog dialog = new FileSaveDialog("Speichern Sie Ihre Datei", "/home/user/documents");
dialog.setCustomFilters(true);
String result = dialog.show();

Beste Praktiken

• Vordefinierte Dateinamen: Stellen Sie einen logischen Standarddateinamen zur Verfügung, wo dies zutreffend ist.
• Bestätigen Sie Überschreibungen: Verwenden Sie CONFIRMATION_DIALOGUE für ExistsAction, um versehentliche Überschreibungen zu verhindern.
• Intuitiver Anfangspfad: Setzen Sie einen Anfangspfad, der mit den Erwartungen der Benutzer übereinstimmt.
• Internationalisierung: Passen Sie den Dialogtext an, um die Benutzerfreundlichkeit für internationale Benutzer zu verbessern.
• Dateityp-Filter: Nutzen Sie Filter, um Dateitypen zu beschränken und Benutzer zu validen Dateierweiterungen zu leiten.