跳至主要内容

文件保存对话框

在 ChatGPT 中打开
Shadow 24.21
Java API

FileSaveDialog 是一个模态对话框，旨在允许用户将文件保存到服务器文件系统的指定位置。该对话框会阻止应用程序执行，直到用户提供文件名并确认操作或取消对话框。

OptionDialog.showFileSaveDialog("保存您的文件");

使用​

FileSaveDialog 提供了一种简化的方法来将文件保存到文件系统，提供用户可配置的文件命名和处理现有文件的选项。

显示代码

结果​

FileSaveDialog 返回所选路径作为字符串。如果用户取消对话框，结果将为 null。

对话框目的

该对话框实际上并不导致任何文件被保存，而是返回用户选择的文件名。

信息

结果字符串从 show() 方法或等效的 OptionDialog 方法返回，如下所示。

String result = OptionDialog.showFileSaveDialog(
    "保存您的文件", "/home/user/documents", "report.xls");

if (result != null) {
  OptionDialog.showMessageDialog("已将文件保存到: " + path, "选择的路径");
} else {
  OptionDialog.showMessageDialog("未选择路径", "选择的路径",
      MessageDialog.MessageType.ERROR);
}

已存在的操作​

FileSaveDialog 在指定名称的文件已存在时提供可配置的行为：

  • ACCEPT_WITHOUT_ACTION: 选择被接受，无需用户额外操作。
  • ERROR_DIALOGUE: 向用户显示错误对话框；该选择不被允许。
  • CONFIRMATION_DIALOGUE: 向用户显示请求确认的对话框。这是默认设置。
FileSaveDialog dialog = new FileSaveDialog(
  "保存您的文件", "/home/user/documents", "report.xls");
dialog.setExistsAction(FileSaveDialog.ExistsAction.ERROR_DIALOGUE);
String result = dialog.show();

选择模式​

FileSaveDialog 支持不同的选择模式，允许您根据特定需求调整选择方法：

  1. FILES: 仅允许选择文件。
  2. DIRECTORIES: 仅允许选择目录。
  3. FILES_AND_DIRECTORIES: 允许选择文件和目录。

初始路径​

使用初始路径指定对话框打开的目录。这有助于用户从逻辑目录开始他们的保存操作。

FileSaveDialog dialog = new FileSaveDialog(
  "保存您的文件", "/home/user/documents", "report.xls");
String result = dialog.show();

限制​

您可以使用 setRestricted(boolean restricted) 方法将对话框限制为特定目录，从而防止用户导航到外部。

FileSaveDialog dialog = new FileSaveDialog(
  "保存您的文件", "/home/user/documents", "report.xls");
dialog.setRestricted(true);
dialog.show();

文件名​

为保存操作设置默认文件名，以指导用户并减少错误。

FileSaveDialog dialog = new FileSaveDialog("保存您的文件");
dialog.setName("report.xls");
String result = dialog.show();

国际化 (i18n)​

组件内的标题、描述、标签和消息可以使用 FileSaveI18n 类完全自定义。这确保对话框能够根据各种本地化或个性化需求进行调整。

FileSaveDialog dialog = new FileSaveDialog("保存您的文件");
FileChooserI18n i18n = new FileChooserI18n();
i18n.setChoose("选择");
i18n.setCancel("取消");
dialog.setI18n(i18n);

过滤器​

FileSaveDialog 允许您设置过滤器，以限制可以保存的文件类型，使用 setFilters(List<FileSaveFilter> filters) 方法。

显示代码

自定义过滤器​

您可以启用自定义过滤器，允许用户定义自己的文件过滤器，使用 setCustomFilters(boolean customFilters) 方法。过滤器默认保存在本地存储中，并在后续对话框调用时恢复。

FileSaveDialog dialog = new FileSaveDialog("保存您的文件", "/home/user/documents");
dialog.setCustomFilters(true);
String result = dialog.show();

最佳实践​

  • 预定义文件名: 在适用时提供一个逻辑默认文件名。
  • 确认覆盖: 对于 ExistsAction 使用 CONFIRMATION_DIALOGUE 以防止意外覆盖。
  • 直观的初始路径: 设置与用户期望一致的初始路径。
  • 国际化: 自定义对话框文本，以提高国际用户的可用性。
  • 文件类型过滤器: 利用过滤器限制文件类型，指导用户朝有效文件扩展名方向前进。