Visindigo::Utility::SevenZipBinder Class

成员函数文档

[noexcept, since Visindigo 0.16.0] SevenZipBinder::~SevenZipBinder()

析构函数。由VisindigoCore在Disable时自动调用。

这个function 从 Visindigo 0.16.0 开始支持。

[since Visindigo 0.16.0] void SevenZipBinder::bind7zaBinary(const QString &exePath)

绑定7za.exe的路径，如果不设置，则默认为"./7za.exe"，即软件执行目录下的7za.exe。

exePath 7za.exe的路径。

这个function 从 Visindigo 0.16.0 开始支持。

[since Visindigo 0.16.0] bool SevenZipBinder::compressFilesToZip(const QStringList &filePaths, const QString &arcPath, Visindigo::Utility::SevenZipBinder::CompressFormat format = zip, const QString &password = "")

压缩文件到指定的压缩包路径，支持多种压缩格式。filePaths可以是多个文件或一个文件夹（会压缩整个文件夹）。如果正在处理其他任务，则返回false。

filePaths 待压缩的文件或文件夹路径列表。 arcPath 输出压缩包的路径。 format 压缩格式，不能是仅支持解压的格式。 password 压缩包密码，为空表示不加密。

return 任务已开始返回true；正在处理其他任务或格式不支持压缩时返回false。

这个function 从 Visindigo 0.16.0 开始支持。

[since Visindigo 0.16.0] bool SevenZipBinder::decompressFile(const QString &arcPath, const QString &outputPath, Visindigo::Utility::SevenZipBinder::CompressFormat format = zip, const QString &password = "")

解压压缩包到指定的输出路径，支持多种压缩格式。如果正在处理其他任务，则返回false。

arcPath 待解压的压缩包路径。 outputPath 解压输出目录。 format 压缩包格式。 password 压缩包密码，为空表示未加密。

return 任务已开始返回true；正在处理其他任务时返回false。

这个function 从 Visindigo 0.16.0 开始支持。

[since Visindigo 0.16.0] QString SevenZipBinder::get7zaBinaryPath() const

获取当前绑定的7za.exe路径。

这个function 从 Visindigo 0.16.0 开始支持。

[static, since Visindigo 0.16.0] Visindigo::Utility::SevenZipBinder *SevenZipBinder::getInstance()

获取SevenZipBinder实例

这个function 从 Visindigo 0.16.0 开始支持。

[since Visindigo 0.16.0] bool SevenZipBinder::isBusy() const

检查7za.exe是否正在处理任务。

return 正在处理任务时返回true。

这个function 从 Visindigo 0.16.0 开始支持。

[since Visindigo 0.17.0] bool SevenZipBinder::isValid() const

检查压缩功能是否可用。

请注意，这个函数只是单纯检查目标文件是否存在，如果设置的是无效的7za.exe路径，或者7za.exe无法正常运行， 这个函数也不会检测到。请确保7za.exe是可执行的，并且在调用压缩或解压函数之前已经绑定了正确的路径。

return 已绑定的7za.exe文件存在时返回true。

这个function 从 Visindigo 0.17.0 开始支持。

[signal, since Visindigo 0.16.0] void SevenZipBinder::processed(bool success)

当7za.exe完成处理时发出此信号，success表示处理是否成功。

success 处理是否成功。

这个function 从 Visindigo 0.16.0 开始支持。

[signal, since Visindigo 0.16.0] void SevenZipBinder::processing(const QString &fileName, float percent)

当7za.exe正在处理文件时发出此信号，fileName是当前正在处理的文件名，percent是处理进度的百分比。

由于7za.exe的压缩逻辑，文件名的提示进度远远快于实际的压缩进度，譬如如果有100个文件，则可能会出现 从50%开始就只显示第100个文件的名字，因此请依赖百分比来判断实际的处理进度。fileName仅供显示参考。

fileName 当前正在处理的文件名，仅供显示参考。 percent 处理进度的百分比。

这个function 从 Visindigo 0.16.0 开始支持。