iOS中使用NSProgress类来创建UI进度条的方法详解

2020-01-15 16:14:24王振洲

六、关于NSProgress对象的用户配置字典

在NSProgress对象的用户字典中可以设置一些特定的键值来进行显示模式的设置,示例如下:


//设置剩余时间 会影响localizedAdditionalDescription的值
/*
例如:0 of 10 — About 10 seconds remaining
*/
[progress setUserInfoObject:@10 forKey:NSProgressEstimatedTimeRemainingKey];
//设置完成速度信息 会影响localizedAdditionalDescription的值
/*
例如:Zero KB of 10 bytes (15 bytes/sec)
*/
[progress setUserInfoObject:@15 forKey:NSProgressThroughputKey];
/*
下面这些键值的生效 必须将NSProgress对象的kind属性设置为 NSProgressKindFile
NSProgressFileOperationKindKey键对应的是提示文字类型 会影响localizedDescription的值
NSProgressFileOperationKindKey可选的对应值如下:
NSProgressFileOperationKindDownloading: 显示Downloading files…
NSProgressFileOperationKindDecompressingAfterDownloading: 显示Decompressing files…
NSProgressFileOperationKindReceiving: 显示Receiving files…
NSProgressFileOperationKindCopying: 显示Copying files…
*/
 [progress setUserInfoObject:NSProgressFileOperationKindDownloading forKey:NSProgressFileOperationKindKey];
/*
NSProgressFileTotalCountKey键设置显示的文件总数 
例如:Copying 100 files…
*/
 [progress setUserInfoObject:@100 forKey:NSProgressFileTotalCountKey];
//设置已完成的数量
[progress setUserInfoObject:@1 forKey:NSProgressFileCompletedCountKey];

 

七、在UI中显示进度步骤总结
以下有几个在视图或者视图控制器中显示进度的步骤:
1.在你调用一个长时间运行的任务之前,借助+progressWithTotalUnitCount:.方法建立一个NSProgress实例。 参数totalUnitCount将会包括“要完成的总工作单元的数量”。
 
有一点很重要,要从UI图层的角度完全理解这个数值;你不会被要求猜测有多少个实际工作对象以及有多少种类的工作单元(字节?像素?文字行数?)。如果你遍历集合并且计划为每一个集合元素调用该实例对象,该参数经常会是1或者也许是一个集合中的元素的数量 。
 
2.使用KVO注册一个进度的fractionCompleted属性的观察者。类似于NSOperation,NSProgress被设计借助KVO来使用。在MAC,这使得通过Cocoa Bindings绑定一个NSProgress实例到一个进度条或者标签上变得非常容易。在iOS上,你将会在KVO observer handle中手动更新你的UI。
 
除了fractionCompleted, completedUnitCount和totalUnitCount属性之外,NSProgress也有一个localizedDescription (@"50% completed"),并且还有一个localized Additional Description (@"3 of 6"),其能够被绑定到文本标签。KVO通知在改变NSProgress对象属性值的线程中发送,因此确保在你的主线程中手动更新UI。
 
3.当前的进度对象通过调用-becomeCurrentWithPendingUnitCount:方法建立新的进度对象。在这里,pendingUnitCount这个参数相当于“是要被接收者完成的总的工作单元的量要完成的工作的一部分”。你可以多次调用这个方法并且每次传递totalUnitCount(本次代码完成的占比)的一部分。在集合元素的迭代示例中,我们将会在每一次迭代中调用[progress becomeCurrentWithPendingUnitCount:1];