95.JHCreateDigClockProg(创建数字时钟)
JHZRESULT JHZAPI JHCreateDigClockProg(
HANDLE hdl,
unsigned short wid,
unsigned short rev,
unsigned long style,
unsigned long format,
unsigned long timeoffset,
const char * pformatstring) ;
参数:
hdl [IN] 实例句柄,与控制卡相对应。
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] 时间偏移,单位秒,可用于实现多时区时间显示, 有符号数值。
pformatstring [IN] 指向存储文本格式化字符串的内存空间。文本格式化字符串的
格式如下(注意, 下面描述中注意大小写的形式,若须要显示“%”,则在 sFORMAT 中需要填补两个百分号,即“%%”;换行符为 ’\n ’, 即 0x0A;水平制表符 ’\t ’,即 0x09,显示为 4 个 ASCII 空格符): 年: %yyyy 或%yy,分别用于显示四位年份或两位年份;
月: %M 或%MM;%M 为月份是几位就显示几位, %MM 为不足两位数的月 份,前面补零;
日: %d 或%dd;%d 为日期是几位就显示几位, %dd 为不足两位数的日 期,前面补零;
时: %H,%HH,%h,%hh;H 是 24 小时制, h 是 12 小时制;%H 和%h 为时钟是几位就显示几位,%HH 和%hh 为不足两位数的时钟,前 面补零;
分: %m 或%mm;%m 为分钟是几位就显示几位, %mm 为不足两位数的分 钟,前面补零;
秒: %s 或%ss;%s 为秒钟是几位就显示几位, %ss 为不足两位数的秒 钟,前面补零;
星期: %w 或%W;%w 为英文星期缩写; %W 为中文星期数; %w:Sun;Mon;Tue;Wed;Thu;Fri;Sat;
%W:星期日; 星期一;星期二; 星期三; 星期四; 星期五;星期六;
上/下午: %t 或%T;%t 为英文,AM 或 PM;%T 为中文,上午或下午;
一个文本格式化字符串可以为“%yyyy 年%MM 月%dd 日 %HH 时%mm 分%ss 秒 %W”,年、月、日、时、分、秒、星期都是可选的, 例如, 如果不 需要在显示屏上显示年份,文本格式化字符串改为“%MM 月%dd 日 %HH 时%mm 分%ss 秒 %W”。
注: FORMAT 属性说明, 主要注意两类,单行文本和多行文本
1. 单行文本时:
忽略 wordbreak 自动换行设置, 无论是自动换行或是手动在命令中添加换行符 ’\n ’,均忽
略,不作换行处理,
2. 多行文本时:
根据设置不作限制, 自动换行和手动换行可同时支持;
但是若文本显示所需区域超过当前限制区域, 建议做如下处理:
1. 若为单行文本, 建议不要设置水平居中;其他可任意搭配;
2. 若为多行文本, 若使用了自动换行, 建议不要使用垂直居中对齐;若无自动换行, 建议
不要使用任何居中对齐方式;
使用时若遇到上面情况, 可参照上面说明使用,否则为了整体显示效果,系统会自行裁剪部
分数据;
返回值:
JR_OK 成功
JR_INVALID_PARAMETER 参数错误
JR_INVALID_OBJECT 无效的对象
功能描述:
在实例句柄对应控制卡中根据指定的参数在分区编号为 wid 的分区上创建高级时 钟节目。