Dialogue de Sauvegarde de Fichier

Ouvrir dans ChatGPT

Shadow 24.21

Java API

FileSaveDialog est un dialogue modal conçu pour permettre aux utilisateurs de sauvegarder un fichier à un emplacement spécifié sur le système de fichiers du serveur. Le dialogue bloque l'exécution de l'application jusqu'à ce que l'utilisateur fournisse un nom de fichier et confirme l'action ou annule le dialogue.

OptionDialog.showFileSaveDialog("Sauvegardez votre fichier");

Usages

Le FileSaveDialog fournit une méthode simplifiée pour sauvegarder des fichiers sur le système de fichiers, offrant des options configurables par l'utilisateur pour le nommage des fichiers et la gestion des fichiers existants.

Afficher le code

Java

Résultat

Le FileSaveDialog renvoie le chemin sélectionné sous forme de chaîne. Si l'utilisateur annule le dialogue, le résultat sera null.

Objectif du Dialogue

Ce dialogue ne sauvegarde en réalité aucun fichier, mais renvoie le nom de fichier que l'utilisateur a sélectionné.

info

La chaîne résultante est renvoyée par la méthode show() ou la méthode équivalente OptionDialog comme montré ci-dessous.

String result = OptionDialog.showFileSaveDialog(
    "Sauvegardez votre fichier", "/home/user/documents", "report.xls");

if (result != null) {
  OptionDialog.showMessageDialog("Fichier sauvegardé à : " + path, "Chemin Sélectionné");
} else {
  OptionDialog.showMessageDialog("Aucun chemin n'est sélectionné", "Chemin Sélectionné",
      MessageDialog.MessageType.ERROR);
}

Action d'Existence

Le FileSaveDialog fournit un comportement configurable lorsqu'un fichier avec le nom spécifié existe déjà :

• ACCEPT_WITHOUT_ACTION : La sélection est acceptée sans action utilisateur supplémentaire.
• ERROR_DIALOGUE : L'utilisateur se voit présenter un dialogue d'erreur ; la sélection n'est pas autorisée.
• CONFIRMATION_DIALOGUE : L'utilisateur se voit présenter un dialogue demandant confirmation. C'est le paramètre par défaut.

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

Mode de Sélection

Le FileSaveDialog prend en charge différents modes de sélection, vous permettant d'adapter la méthode de sélection à vos besoins spécifiques :

1. FILES : Permet la sélection uniquement de fichiers.
2. DIRECTORIES : Permet la sélection uniquement de répertoires.
3. FILES_AND_DIRECTORIES : Permet la sélection à la fois de fichiers et de répertoires.

Chemin Initial

Spécifiez le répertoire où le dialogue s'ouvrira en utilisant le chemin initial. Cela aide les utilisateurs à commencer dans un répertoire logique pour leur opération de sauvegarde.

FileSaveDialog dialog = new FileSaveDialog(
  "Sauvegardez votre fichier", "/home/user/documents", "report.xls");
String result = dialog.show();

Restriction

Vous pouvez restreindre le dialogue à un répertoire spécifique, empêchant les utilisateurs de naviguer en dehors de celui-ci en utilisant la méthode setRestricted(boolean restricted).

FileSaveDialog dialog = new FileSaveDialog(
  "Sauvegardez votre fichier", "/home/user/documents", "report.xls");
dialog.setRestricted(true);
dialog.show();

Nom de Fichier

Définissez un nom de fichier par défaut pour l'opération de sauvegarde afin de guider les utilisateurs et de minimiser les erreurs.

FileSaveDialog dialog = new FileSaveDialog("Sauvegardez votre fichier");
dialog.setName("report.xls");
String result = dialog.show();

Internationalisation (i18n)

Les titres, descriptions, étiquettes et messages au sein du composant sont entièrement personnalisables en utilisant la classe FileSaveI18n. Cela garantit que le dialogue peut être adapté à diverses exigences de localisation ou de personnalisation.

FileSaveDialog dialog = new FileSaveDialog("Sauvegardez votre fichier");
FileChooserI18n i18n = new FileChooserI18n();
i18n.setChoose("Choisir");
i18n.setCancel("Annuler");
dialog.setI18n(i18n);

Filtres

Le FileSaveDialog vous permet de définir des filtres pour limiter les types de fichiers qui peuvent être sauvegardés en utilisant la méthode setFilters(List<FileSaveFilter> filters).

Afficher le code

Java

Filtres Personnalisés

Vous pouvez activer des filtres personnalisés pour permettre aux utilisateurs de définir leurs propres filtres de fichiers en utilisant la méthode setCustomFilters(boolean customFilters). Les filtres sont sauvegardés dans le stockage local par défaut et restaurés lors des invocations ultérieures du dialogue.

FileSaveDialog dialog = new FileSaveDialog("Sauvegardez votre fichier", "/home/user/documents");
dialog.setCustomFilters(true);
String result = dialog.show();

Meilleures Pratiques

• Noms de Fichiers Pré-définis : Fournissez un nom de fichier par défaut logique lorsque cela est applicable.
• Confirmez les Écrasements : Utilisez CONFIRMATION_DIALOGUE pour ExistsAction pour éviter les écrasements accidentels.
• Chemin Initial Intuitif : Définissez un chemin initial qui correspond aux attentes de l'utilisateur.
• Internationalisation : Personnalisez le texte du dialogue pour améliorer l'utilisabilité pour les publics internationaux.
• Filtres de Types de Fichiers : Utilisez des filtres pour restreindre les types de fichiers et guider les utilisateurs vers des extensions de fichiers valides.