跳至主要内容

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. 限制目录导航: 在必要时将对话框限制在特定目录，以防止用户导航到未授权区域。