跳到主要内容

文件选择对话框

在ChatGPT中打开
Shadow 24.02
Java API

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

OptionDialog.showFileChooserDialog("选择文件");

用法​

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