## 文件管理器 -e/–exec 命令行参数详解

#### 用法示例：

    dde-file-manager -e '{"eventType":"OpenUrl", "urlList":["file:///usr/bin"], "mode":2}'

###### 在 -e 参数后跟Json格式的数据，数据中需要的参数：

属性 | 介绍 | 备注 | 可选值
--- | --- | --- | ---
eventType | 要执行的事件的类型 | 必选 | OpenFile, OpenFileByApp, CompressFiles, DecompressFile, DecompressFileHere, WriteUrlsToClipboard, RenameFile, DeleteFiles, MoveToTrash, RestoreFromTrash, PasteFile, NewFolder, NewFile, OpenFileLocation, CreateSymlink, FileShare, CancelFileShare, OpenInTerminal, OpenNewWindow
… | 此类型事件所需要的参数 | 必选 | 例如 url/urlList 等

#### 各类型事件所需要的参数：

##### OpenUrl：打开一个url（文件或者是路径）

参数 | 介绍 | 备注 | 数据类型 | 可选值
--- | --- | --- | --- | ---
urlList | 要打开的url地址的列表形式 | 必选 | 字符串列表 | 如：[“file:///home”, “file:///home/example2.jpg”]
mode | 打开模式 | 必选 | 整型 | 1(在新窗口中打开路径，如果已经有窗口对应的路径为此路径则激活此窗口) 2(强制在新的窗口中打开路径)

##### OpenFile：打开一个文件

参数 | 介绍 | 备注 | 数据类型 | 可选值
--- | --- | --- | --- | ---
url | 要打开的文件的url地址 | 必选 | 字符串 | 任意文件，如：”file:///home/example.txt”

##### OpenFileByApp：制定应用程序打开文件

参数 | 介绍 | 备注 | 数据类型 | 可选值
--- | --- | --- | --- | ---
url | 要打开的文件的url地址 | 必选 | 字符串 | 任意文件，如：”file:///home/example.txt”
appName | 指定被调用程序的desktop文件绝对路径 | 必选 | 字符串 | 如：”/usr/share/applications/dde-file-manger.desktop”

##### CompressFiles：压缩文件

参数 | 介绍 | 备注 | 数据类型 | 可选值
--- | --- | --- | --- | ---
urlList | 要压缩的文件的url地址的列表形式 | 必选 | 字符串列表 | 任意文件，如：[“file:///home/example1.png”, “file:///home/example2.jpg”]

##### DecompressFile：解压文件

参数 | 介绍 | 备注 | 数据类型 | 可选值
--- | --- | --- | --- | ---
urlList | 要解压的文件的url地址的列表形式 | 必选 | 字符串列表 | 任意文件，如：[“file:///home/example1.rar”, “file:///home/example2.zip”]

##### DecompressFileHere：解压文件到此文件所在目录

参数 | 介绍 | 备注 | 数据类型 | 可选值
--- | --- | --- | --- | ---
urlList | 要解压的文件的url地址的列表形式 | 必选 | 字符串列表 | 任意文件，如：[“file:///home/example1.rar”, “file:///home/example2.zip”]

##### WriteUrlsToClipboard：写系统剪切板

参数 | 介绍 | 备注 | 数据类型 | 可选值
--- | --- | --- | --- | ---
urlList | 要写入到剪切板文件url地址的列表形式 | 必选 | 字符串列表 | 任意文件，如：[“file:///home/example1.png”, “file:///home/example2.jpg”]
action | 粘贴时要执行的动作 | 必选 | 整型 | 0(剪切)，1(复制)

##### RenameFile：重命名文件

参数 | 介绍 | 备注 | 数据类型 | 可选值
--- | --- | --- | --- | ---
from | 被改名文件的url | 必选 | 字符串 | 任意文件，如：”file:///home/example.old”
to | 改名后的url | 必选 | 字符串 | 如：”file:///home/example.new”

##### DeleteFiles：彻底删除文件

参数 | 介绍 | 备注 | 数据类型 | 可选值
--- | --- | --- | --- | ---
urlList | 被删除文件url地址的列表形式 | 必选 | 字符串列表 | 任意文件，如：[“file:///home/example1.png”, “file:///home/example2.jpg”]
silent | 是否静默操作（不弹出任何确认对话框） | 可需（默认为false） | 布尔 | false/true

##### MoveToTrash：将文件移动到回收站

参数 | 介绍 | 备注 | 数据类型 | 可选值
--- | --- | --- | --- | ---
urlList | 要移动到回收站文件url地址的列表形式 | 必选 | 字符串列表 | 任意文件，如：[“file:///home/example1.png”, “file:///home/example2.jpg”]

##### RestoreFromTrash：还原回收站内的文件

参数 | 介绍 | 备注 | 数据类型 | 可选值
--- | --- | --- | --- | ---
urlList | 从回收站恢复文件url地址的列表形式 | 必选 | 字符串列表 | 任意文件，如：[“trash:///example1.png”, “trash:///example2.jpg”]

##### PasteFile：复制或剪切文件

参数 | 介绍 | 备注 | 数据类型 | 可选值
--- | --- | --- | --- | ---
urlList | 被操作文件url地址的列表形式 | 必选 | 字符串列表 | 任意文件，如：[“file:///home/example1.png”, “file:///home/example2.jpg”]
action | 粘贴时要执行的动作 | 必选 | 整型 | 0(剪切)，1(复制)
targetUrl | 要粘贴到的地方 | 必选 | 字符串 | 如：”file:///home”

##### NewFolder：新建文件夹

参数 | 介绍 | 备注 | 数据类型 | 可选值
--- | --- | --- | --- | ---
url | 在哪个目录下新建 | 必选 | 字符串列表 | 如：”file:///home/”

##### NewFile：新建文件

参数 | 介绍 | 备注 | 数据类型 | 可选值
--- | --- | --- | --- | ---
url | 在哪个目录下新建 | 必选 | 字符串 | 如：”file:///home/”
suffix | 新文件的后缀 | 必选 | 字符串 | 如：”txt”

##### OpenFileLocation：打开文件所在位置

参数 | 介绍 | 备注 | 数据类型 | 可选值
--- | --- | --- | --- | ---
url | 操作对象 | 必选 | 字符串 | 如：”file:///home/example.txt”

##### CreateSymlink：创建软链接

参数 | 介绍 | 备注 | 数据类型 | 可选值
--- | --- | --- | --- | ---
fileUrl | 操作对象 | 必选 | 字符串 | 如：”file:///home/example.txt”
toUrl | 目标路径 | 必选 | 字符串 | 如：”file:///home/”

##### FileShare：共享文件夹

参数 | 介绍 | 备注 | 数据类型 | 可选值
--- | --- | --- | --- | ---
url | 要共享的文件夹的url | 必选 | 字符串 | 如：”file:///home/”
name | 共享后显示的名称 | 必选 | 字符串 | 如：”zccrs的共享”
isWritable | 目录是否可写 | 可选（默认false） | 布尔 | false/true
allowGuest | 是否允许匿名访问 | 可选（默认false） | 布尔 | false/true

##### CancelFileShare：取消共享文件夹

参数 | 介绍 | 备注 | 数据类型 | 可选值
--- | --- | --- | --- | ---
url | 要取消共享的文件夹的url | 必选 | 字符串 | 如：”file:///home/”

##### OpenInTerminal：在指定路径下打开终端

参数 | 介绍 | 备注 | 数据类型 | 可选值
--- | --- | --- | --- | ---
url | 目标url | 必选 | 字符串 | 如：”file:///home/”

##### OpenNewWindow：在新窗口中打开文件夹

参数 | 介绍 | 备注 | 数据类型 | 可选值
--- | --- | --- | --- | ---
urlList | 要打开的文件夹url地址的列表形式 | 必选 | 字符串列表 | 任意文件，如：[“file:///home/user1”, “file:///home/user2”]
force | 是否强制在新窗口中打开，为false时，如果当前已打开窗口中有currentUrl==url的窗口时时不会打开新的窗口，只会激活此窗口。 | 可选 | 布尔（默认false） | false/true