阅读( 220 ) 我要纠错

98.  JHCreateCountdownProg(正计时节目)

 

  JHZRESULT JHZAPI JHCreateCountupProg(

HANDLE hdl,

unsigned short wid,

unsigned short rev,

unsigned long style,

unsigned long format,

unsigned long timeoffset,

unsigned long flag,

const JHSYSTEMTIME * ptime,

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。

2位 19- 16:颜色(注: 0000 表示使用系统当前颜色;1000 为黑色)

 18:蓝色。

 17:绿色。

 16:红色。

 15- 8:字体 ID;有效值为 0-254;为 0 时使用当前字体 ID。

7- 6:水平对齐 HALIGN

00;左对齐。

01:水平居中对齐。

10:右对齐。

5- 4:垂直对齐方式

00:上对齐。

01:垂直居中对齐。


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   参数错误

JR_INVALID_OBJECT    无效的对象


功能描述:

在实例句柄对应控制卡中根据指定的参数在分区编号为 wid 的分区上创建正计时 节目。


注: 若将 flag 设置为 1 即相对当前时间, 则可用于比如临时计时、计算运行时间等用途。



×