154. JHCreateCountDownProgIst(创建倒计时指令)
JHZRESULT JHZAPI JHCreateCountDownProgIst(
HANDLE phdl,
unsigned short index,
unsigned short wid,
unsigned short rev,
unsigned long style,
unsigned long format,
unsigned long timeoffset,
unsigned long flag,
const JHSYSTEMTIME * ptime,
const char * pformatstring);
参数:
phdl [IN] 实例句柄,与控制卡对应。
index [IN] 指令在批处理文件中基于1开始的索引。
wid [IN] 分区编号,有效值为控制卡中已经创建的分区, 或 0xFFFF;为 0xFFFF,时为向所有分区发送同一个节目。
rev [IN] 节目标识,用于单分区多节目。
位 15-8:节目编号,同分区中具有唯一性,值越小播放顺序越靠前,有效范 围 0~63;
位 7-0:保留, 始终为 0。
style [IN] 节目样式。
位 31-4:保留,始终为 0;
位 3:是否按队列加载, 仅永久节目有效,为 0 表示立即,为 1 表示按队 列顺序加载;
位 2:加载时是否擦除分区, 为 0 表示不擦除,为 1 表示擦除;
位 1:节目属性,为 0 表示临时节目(即掉电易失),为 1 表示永久节目
(掉电不易失) ;
位 0:保留,始终为 0;
format [IN] 文本显示格式。
位 31-20:保留,始终为 0。
位 19- 16:颜色(注: 0000 表示使用系统当前颜色;1000 为黑色) 位 18:蓝色。
位 17:绿色。
位 16:红色。
位 15- 8:字体 ID;有效值为 0-254;为 0 时使用当前字体 ID。
位 7- 6:水平对齐 HALIGN
00:左对齐。
01:水平居中对齐。
10:右对齐。
位 5- 4:垂直对齐方式
00:上对齐。
01:垂直居中对齐。
10:下对齐。
位 3:保留,始终为 0。
位 2:wordbreak,自动换行, 为 0,不自动换行, 为 1,自动换行; 位 1:单行文本; 0 表示多行文本, 1 表示单行文本。
位 0:高级文本,0 表示普通文本, 1 表示高级文本;保留, 始终为 0。
timeoffset [IN] 时间偏移,单位秒,可用于实现多时区时间显示,有符号数值。
flag [IN] 控制信息
位 31-1:保留,必须为 0;
位 0:参考时间类型, 为 0 表示 ptime 为绝对时间,为 1 表示 ptime 为相对当前的时间;
注: 当 FLAG 的位 0 为 1 时,ptime 中只有 wDay、wHour、wMinute、wSecond 有效,参考 的时间点为加载时的时间和这四个值所表示的时间之和((wDay*86400 )+ (wHour*3600)+(wMinute*60)+ wSecond)。
ptime [IN] 指向 JHSYSTEMTIME 类型的内存空间。JHSYSTEMTIME 结构的格式如下所示:
wYear:年
wMonth:月,有效值为 1-12;
wDayOfWeek:星期, 保留值,始终为 0
wDay: 日, 有效值为 1-31;
wHour:时,有效值为 0-23;
wMinute:分, 有效值为 0-59;
wSecond:秒, 有效值为 0-59;
wMilliseconds:毫秒, 保留值, 始终为 0;
注:表示截止时间(倒计时到何时结束) ,其类型由 FLAG 的位 0 决定。
pformatstring [IN] 指向存储待显示的时间格式字符串内存空间。时间格式化字符串
格式如下:
不能包含 0x00; (注意, 下面描述中注意大小写的形式)
日: %D,总的天数;
时: %H 或%h, %H 为总的时钟数,有几位就显示几位; %h 为当前天中的时钟数, 不足两位数的时钟, 前面补零;
分: %M 或%m;%M 为总的分钟数,有几位就显示几位; %m 为当前小 时中的分钟数, 不足两位数的分钟, 前面补零;
秒: %S 或%s;%S 为总的秒钟数,有几位就显示几位; %s 为当前分 钟中的秒数,不足两位数的秒钟,前面补零;
返回值:
JR_OK 成功
JR_INVALID_PARAMETER 参数错误
IR_INVALID_OBJECT 无效的对象
IR_NOT_ENOUGH_CORE 内存不足
功能描述:
在批处理文件中索引为 index 的位置上添加创建倒计时指令。将要创建的倒计时在 分区编号为 wid 的显示区域内显示。一个显示屏可以分为若干个区域,每个区域以一个 分区编号来标记。创建倒计时用户可指定倒计时的显示格式。