阅读( 245 ) 我要纠错

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 的显示区域内显示。一个显示屏可以分为若干个区域,每个区域以一个 分区编号来标记。创建正计时用户可指定正计时的显示格式。



×