阅读( 230 ) 我要纠错

94.JHCreateSimpleDigClockProg(创建简易时钟)

 

JHZRESULT JHZAPI JHCreateSimpleDigClockProg(

 

            HANDLE hdl,

            unsigned short wid,

            unsigned short rev,

            unsigned long style,

            unsigned long format,

            unsigned long timeoffset) ;

 

 参数:

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] 时间偏移,单位秒,可用于实现多时区时间显示,有符号数值。



注: FORMAT 属性说明, 主要注意两类,单行文本和多行文本

1.  单行文本时:

忽略 wordbreak 自动换行设置, 无论是自动换行或是手动在命令中添加换行符 ’\n ’,均忽略,不作换行处理,


2. 多行文本时:

根据设置不作限制, 自动换行和手动换行可同时支持;

 

但是若文本显示所需区域超过当前限制区域, 建议做如下处理:

1 . 若为单行文本, 建议不要设置水平居中; 其他可任意搭配;

2 . 若为多行文本, 若使用了自动换行, 建议不要使用垂直居中对齐; 若无自动换行, 建议 不要使用任何居中对齐方式;

使用时若遇到上面情况, 可参照上面说明使用,否则为了整体显示效果,系统会自行裁剪部 分数据;


返回值:

JR_OK         成功

JR_INVALID_OBJECT   无效的对象


功能描述:

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




×