Dtk::Mount::DDiskJob类 参考

提供对设备任务接口的操作 更多...

#include <ddiskjob.h>

类 Dtk::Mount::DDiskJob 继承关系图:

Dtk::Mount::DDiskJob 的协作图:

Public 槽
void	cancel (const QVariantMap &options)
	槽函数，取消任务操作

信号
void	completed (bool success, const QString &message)
	信号，告知任务结束
void	progressChanged (double progress)
	信号，告知任务处理进度
void	rateChanged (quint64 rate)
	信号，告知任务处理速率改变
void	expectedEndTimeChanged (quint64 expectedEndTime)
	信号，告知任务预测结束时间改变

Public 成员函数
	~DDiskJob () override
	析构函数
QString	path () const
	获取当前任务对应的任务接口路径
QStringList	objects () const
	获取当前任务关联的对象列表
bool	cancelable () const
	获取当前任务是否可取消
bool	progressValid () const
	获取当前进度数值是否有效
double	progress () const
	获取当前任务进度
QString	operation () const
	获取当前操作类型
quint32	startedByUid () const
	获取启动当前任务的用户 uid
quint64	bytes () const
	获取当前任务需要处理的字节数
quint64	expectedEndTime () const
	获取当前任务预测的结束 unix 时间（毫秒）
quint64	rate () const
	获取当前任务处理速率
quint64	startTime () const
	获取当前任务开始时间（毫秒）

Protected 成员函数
	DDiskJob (const QString &path, QObject *parent=nullptr)
	构造函数

属性
QString	path
QStringList	objects
bool	cancelable
bool	progressValid
double	progress
QString	operation
quint32	startedByUid
quint64	bytes
quint64	expectedEndTime
quint64	rate
quint64	startTime

友元
DCORE_NAMESPACE::DExpected< DDiskJob * >	DDeviceManager::createDiskJob (const QString &, QObject *)

详细描述

提供对设备任务接口的操作

构造及析构函数说明

DDiskJob()

DDiskJob::DDiskJob ( const QString &  path, QObject *  parent = nullptr  )

explicitprotected

构造函数

参数

[in]	path	Job 对象路径，形如 /org/freedesktop/UDisks/jobs/...
[in]	parent	父指针

参见

QString DDiskJob::path() const

成员函数说明

bytes()

quint64 DDiskJob::bytes

(

)

const

获取当前任务需要处理的字节数

返回

如果当前任务涉及已知字节数量的操作，例如擦除磁盘，则返回任务需要处理的总字节数，否则返回 0

cancel

void DDiskJob::cancel ( const QVariantMap &  options )

slot

槽函数，取消任务操作

参数

[in]

options

取消任务时的参数列表

cancelable()

bool DDiskJob::cancelable

(

)

const

获取当前任务是否可取消

返回

当前任务是否可取消

返回值

True	当前任务可取消
False	当前任务不可取消

completed

void DDiskJob::completed ( bool  success, const QString &  message  )

signal

信号，告知任务结束

参数

[out]	success	任务处理结果
[out]	message	任务描述信息或错误信息

expectedEndTime()

quint64 DDiskJob::expectedEndTime

(

)

const

获取当前任务预测的结束 unix 时间（毫秒）

返回

若结束时间不可预测，则返回 0

expectedEndTimeChanged

void DDiskJob::expectedEndTimeChanged ( quint64  expectedEndTime )

signal

信号，告知任务预测结束时间改变

参数

[out]

expectedEndTime

当前预测的任务结束 unix 时间（毫秒）

objects()

QStringList DDiskJob::objects

(

)

const

获取当前任务关联的对象列表

返回

关联对象列表，通常为块设备对象或驱动设备对象

operation()

QString DDiskJob::operation

(

)

const

获取当前操作类型

返回

当前任务类型

path()

QString DDiskJob::path

(

)

const

获取当前任务对应的任务接口路径

返回

任务接口路径

progress()

double DDiskJob::progress

(

)

const

获取当前任务进度

返回

当前任务进度，数值范围 0~1

progressChanged

void DDiskJob::progressChanged ( double  progress )

signal

信号，告知任务处理进度

参数

[out]

progress

任务处理进度

progressValid()

bool DDiskJob::progressValid

(

)

const

获取当前进度数值是否有效

返回

当前进度是否有效

返回值

True

当进度有效

rate()

quint64 DDiskJob::rate

(

)

const

获取当前任务处理速率

返回

若任务总量已知，则返回估算的任务处理速率（字节/秒），否则返回 0

rateChanged

void DDiskJob::rateChanged ( quint64  rate )

signal

信号，告知任务处理速率改变

参数

[out]

rate

当前任务处理速率

startedByUid()

quint32 DDiskJob::startedByUid

(

)

const

获取启动当前任务的用户 uid

返回

用户 uid

startTime()

quint64 DDiskJob::startTime

(

)

const

获取当前任务开始时间（毫秒）

返回

任务开始时间

---

该类的文档由以下文件生成:

• include/dtkmount/ddiskjob.h
• docs/dtkmount/ddiskjob.zh_CN.dox