跳至主要内容

File Chooser

在 ChatGPT 中打开
阴影 24.02
Java API

FileChooserDialog 是一个模态对话框，旨在允许用户从服务器文件系统中选择文件或目录。该对话框会阻止应用程序执行，直到用户做出选择或关闭对话框。

使用​

FileChooserDialog 提供了一种从文件系统中选择文件或目录的方式，使用户能够选择用于保存数据的目录或执行文件操作。

显示代码

结果​

FileChooserDialog 返回所选文件或目录的字符串。如果用户关闭对话框而没有做出选择，结果将为 null。

信息

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

String result = OptionDialog.showFileChooserDialog(
  "选择文件", "/home/user", FileChooserDialog.SelectionMode.FILES);

if (result != null) {
  OptionDialog.showMessageDialog("您选择的文件是: " + result, "选择完成");
} else {
  OptionDialog.showMessageDialog("未做出选择", "选择已取消");
}

选择模式​

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

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

初始路径​

FileChooserDialog 允许您指定一个初始路径，显示时对话框将打开到该路径。这可以为用户的文件选择提供一个起点。

FileChooserDialog dialog = new FileChooserDialog("选择文件", "/home/user");
String result = dialog.show();

限制​

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

FileChooserDialog dialog = new FileChooserDialog("选择文件", "/home/user");
dialog.setRestricted(true);
dialog.show();

过滤器​

当选择模式为 FILES 时，FileChooserDialog 允许您设置过滤器，以限制列出文件的类型。您可以使用 setFilters(List<FileChooserFilter> filters) 方法配置过滤器。

显示代码

自定义过滤器​

您可以通过启用自定义过滤器功能来允许用户添加自定义过滤器，使用 setCustomFilters(boolean customFilters) 方法。 自定义过滤器将默认保存在浏览器的本地存储中，并在再次显示对话框时恢复。

FileChooserDialog dialog = new FileChooserDialog("选择文件", "/home/user");
dialog.setCustomFilters(true);
String result = dialog.show();

国际化 (i18n)​

组件中的标题、描述、标签和消息可以通过 FileChooserI18n 类进行完全定制。这种灵活性使您能够根据特定的本地化要求或个性化偏好来定制对话框界面。

FileChooserDialog dialog = new FileChooserDialog("选择文件", "/Users/habof/bbx");
FileChooserI18n i18n = new FileChooserI18n();
i18n.setChoose("选择");
i18n.setCancel("取消");
dialog.setI18n(i18n);

最佳实践​

  1. 清晰简洁的提示: 确保提示消息清晰地解释用户被要求选择的内容。
  2. 适当的选择模式: 选择匹配所需用户操作的选择模式，以确保准确和相关的选择。
  3. 逻辑初始路径: 设置为用户提供有用起点的初始路径，以方便其选择。
  4. 限制目录导航: 在必要时将对话框限制在特定目录，以防止用户导航到未经授权的区域。