155. JHCreateCountUpProgIst(创建正计时指令)
JHZRESULT JHZAPI JHCreateCountUpProgIst(
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;
注: ptime 表示起始时间(从何时开始计时) ,其类型由 FLAG 的位 0 决定 ;若将其设置 为 NULL 则表示 ptime 的所有值为 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 的显示区域内显示。一个显示屏可以分为若干个区域,每个区域以一个 分区编号来标记。创建正计时用户可指定正计时的显示格式。