wps js宏 FileDialog

WPS Office中的JavaScript宏是一种可以通过JavaScript代码实现自动化办公任务的功能。FileDialog是WPS JS API中的一个组件，用于创建文件对话框，允许用户选择文件或文件夹。它通常用于需要用户交互地选择文件路径的场景，比如打开、保存文件或者选择特定文件夹等操作。

FileDialog对象可以用来设置对话框的各种属性，如对话框标题、默认文件夹、文件过滤器等，以适应不同的使用场景。使用FileDialog时，开发者可以为对话框设置监听器，以便在用户选择文件或取消操作时执行相应的JavaScript代码。

以下是一个使用FileDialog的基本示例：

var dialog = wps.ui.FileDialog;
dialog.show({
    title: "选择文件", // 对话框的标题
    defaultPath: "",   // 默认打开的文件夹路径
    fileFilters: [
        {name: "所有文件", extensions: ["*.*"]},
        {name: "文本文件", extensions: ["*.txt"]},
        {name: "图片文件", extensions: ["*.jpg", "*.png"]}
    ],
    success: function (files) { // 用户选择文件后触发
        // files 是一个数组，包含了用户选择的文件路径
        wps.ui.message("您选择了：" + files.join(", "));
    },
    cancel: function () { // 用户取消操作时触发
        wps.ui.message("操作已取消。");
    }
});

在使用FileDialog时，可以自定义多个属性，如：
- `title`：设置对话框标题。
- `defaultPath`：设置对话框默认打开的文件夹路径。
- `fileFilters`：设置文件过滤器，限制用户可以选择的文件类型。
- `success`：当用户选择文件并确认后执行的函数，返回用户选中的文件路径。
- `cancel`：当用户取消对话框时执行的函数。