162. JHCreateGridProg(创建表格节目)
JHZRESULT JHZAPI JHCreateGridProg(
HANDLE hdl,
unsigned short wid,
unsigned short rev,
unsigned long style,
unsigned long format,
unsigned long flag,
const char * pformatstring)
参数:
hdl [IN] 实例句柄,与控制卡相对应。
wid [IN] 分区编号,有效值为 0x0001-0X0003,或 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。
注意:format 不要超过 1200 字节。
flag [IN] 控制信息
位 31-16:节目停留时间(单位: 秒) ,仅在位 1 为 0 时有效; 位 15-2:保留;
位 1:为 0 表示节目时间无限长, 为 1 表示有限节目时间;
注意: 若设置为 0 则不能和其他表格节目切换显示,只显示当前 节目。
位 0:为 0 表示加载节目时擦除当前分区,为 1 表示加载节目时 不擦除当前分区;
pformatstring [IN] 指向存储待显示的表格格式字符串的内存空间。
返回值:
JH_OK 成功
JH_ INVALID_PARAMETER 参数错误
JH_ INVALID_OBJECT 无效的对象
功能描述:
在实例句柄对应控制卡上,根据指定的参数在分区编号为 wid 的分区上创建表格节目。