OmaT_Ot_Progress_Proc
摘要
回调:用于在读取 OT 文件时管理进度条。
语法
<progress_proc_name> (count_or_option)
| 参数 | 类型 | 说明 |
|---|---|---|
count_or_option |
int |
文件读取状态(见详情) |
返回类型
int
若应中止文件读取则返回 PRGC_TRUE,否则返回 PRGC_FALSE。
头文件
oma_ot.h
详情
进度过程(progress proc)使用 ETS 的“Progress Bar Sub-Package“(第 244 页)来管理读取 OT 文件时显示的进度条(OT 文件由 Oma_Ot_Reader_Table_Get() 或 Oma_Ot_Reader_Iterator_Table_Get() 读取)。
如果用 Oma_Ot_Progress_Proc_Set() 注册了进度过程,则在 OT 文件读取过程中该过程会被多次调用。count_or_option 参数指示读取的状态,如下:
- 最初,
count_or_option被设置为将要读取的表的数量。进度过程应使用该数量来设置进度条。 - 随后,每读取一个表,
count_or_option被设置为OMAC_OT_PROGRESS_ADVANCE,表示进度过程应将进度条推进一个文件。如果用户点击了进度条中的 Cancel 按钮,该过程应返回PRGC_TRUE以中止读取。 - 最后,当读取完成时,
count_or_option被设置为OMAC_OT_PROGRESS_FINISH,表示进度过程应关闭进度条。
该回调函数由 Oma_Ot_Progress_Proc_Set() 注册。