zlib.doc

unix下的界面工具

	void	Zexec		执行一个命令~
		参数	char*	待执行的命令行指针
		返回	0	成功
	int	Zprint  	打印一定长字符串
		参数	char*	待打印字符串指针
			int	待打印字符串长度
		返回		未打印字符数(出错后)
	int	Zprintf 	打印一格式化字符串
		参数	char*	待打印格式串指针(同printf, 转换后<256字节)
			...
		返回		未打印字符数(出错后)
	int	Zinkey  	检查并接收一击键~
		返回	0	无击键
			其它	所击键码
	void	Zstrmovf	向前移动字符串并填充空格~
		参数	char*	目标区指针
			int	目标区尺寸
			int	移动首部位移
	void	Zstrmovb	向后移动字符串并填充空格~
		参数	char*	目标区指针
			int	目标区尺寸
			int	移动尾部位移
	int	Zstrlen 	忽略尾部空格的字符串长度
		参数	char*	待处理字符串指针
		返回		字符串长度
	int	Zsleep		等待请求的秒数
		参数	int	请求的秒数
			int(*)()周期性调用处理函数
				返回0继续等待, 否则退出等待
				周期性调用处理函数无参数项
		返回		周期性调用处理函数返回码
	int	Zscreen 	屏幕处理器
				自动显示按钮组及字段组, 光标自动定位于字段组内
				的第一个可编辑位置, 然后循环检测、接收击键并调
				用空闲处理函数
		参数	ZSCREEN*待处理屏幕指针
		返回	0	处理失败
			其它	导致处理结束的键码
	int	Zask    	显示一判断信息并等待回答
		参数	int	窗口起始行(绝对坐标, 0起)
			int	窗口起始列(绝对坐标, 0起)
			char*	窗口标题
			char*	格式化判断信息指针(同printf, 转换后<1024字节)
			...
		返回	0	否
	int	Zmessage	显示一信息直到窗口关闭
				该函数被调用后窗口一直打开直到调用ZWclose关闭
		参数	int	窗口起始行(绝对坐标, 0起)
			int	窗口起始列(绝对坐标, 0起)
			char*	窗口标题
			char*	格式化信息指针(同printf, 转换后<1024字节)
			...
		返回	0	成功(需调用ZWclose关闭)
	void	Zwaitmsg	显示一信息直到按下0键或被空闲处理函数终止
		参数	int	窗口起始行(绝对坐标, 0起)
			int	窗口起始列(绝对坐标, 0起)
			int(*)()空闲(无击键时)处理函数
				返回Esc键码导致退出
				空闲处理函数无参数项
			char*	窗口标题
			char*	格式化信息指针(同printf, 转换后<1024字节)
			...
	void	Zackmsg 	显示一信息直到按下任一键
		参数	int	窗口起始行(绝对坐标, 0起)
			int	窗口起始列(绝对坐标, 0起)
			char*	窗口标题
			char*	格式化信息指针(同printf, 转换后<1024字节)
			...
	void	Zwarning	显示一警告信息直到按下任一键
		参数	int	窗口起始行(绝对坐标, 0起)
			int	窗口起始列(绝对坐标, 0起)
			char*	格式化信息指针(同printf, 转换后<1024字节)
			...
	void	Zerror		显示一错误信息直到按下任一键
		参数	int	窗口起始行(绝对坐标, 0起)
			int	窗口起始列(绝对坐标, 0起)
			char*	格式化信息指针(同printf, 转换后<1024字节)
			...
	void	Znotice 	显示一注意信息直到按下任一键
		参数	int	窗口起始行(绝对坐标, 0起)
			int	窗口起始列(绝对坐标, 0起)
			char*	格式化信息指针(同printf, 转换后<1024字节)
			...
	int	Zbrowse 	浏览器
				检查可供浏览的数据项数, 数据项数<2时分别调用无
				数据项或唯一数据项处理函数, 并在其返回码非零时
				以该码退出; 否则打开浏览窗口, 调用创建初始函数
				而后调用屏幕处理器进行处理
				关于浏览源中按钮组的定义:
				UP/8, DOWN/2, LEFT/4, RIGHT/6, HOME/7, END/1,
				PGUP/9, PGDN/3等按钮的合法性检查和按动处理函数
				一般设置为0 以使用内部标准处理函数; 如需将上述
				浏览控制键用于其它用途, 务必填写该键的合法性检
				查和按动处理函数
		参数	ZBROWSE*浏览源指针
		返回	0	处理失败
			其它	导致处理结束的键码
	int	Zmenu   	执行由菜单结构定义的菜单
				该函数可用于选择操作
		参数	ZMENU*	待执行菜单结构指针
		返回	-1	操作失败
			其它	导致退出的菜单项号
	void	Zalarm		设置或取消报时功能(使用缺省窗口)
		参数	int	日期显示行(绝对坐标, 0起, <0禁止显示)
			int	日期显示行(绝对坐标, 0起, <0禁止显示)
			int	时间显示行(绝对坐标, 0起, <0禁止显示)
			int	时间显示行(绝对坐标, 0起, <0禁止显示)
			int	时间间隔(>0设置, <=0取消)
			int	显示属性(参见显示属性类常数)
窗口类
	int	ZWopen  	建立并打开一新窗口使之成为当前窗口
		参数	int	窗口起始行(绝对坐标, 0起)
			int	窗口起始列(绝对坐标, 0起)
			int	窗口高度(完整落于屏幕内)
			int	窗口宽度(完整落于屏幕内)
			int	窗口类型(窗口定义类常数)
			char*	窗口标题(0或""无标题)
		返回	0	成功
	void	ZWclose 	关闭当前窗口
	int	ZWrow   	获取当前窗口起始行
		返回		当前窗口起始行
	int	ZWcol   	获取当前窗口起始列
		返回		当前窗口起始列
	int	ZWheight	获取当前窗口高度
		返回		当前窗口高度
	int	ZWwidth 	获取当前窗口宽度
		返回		当前窗口宽度
	int	ZWattr		设置或获取当前窗口显示属性
		参数	int	新的显示属性(显示属性类常数, <0不变)
		返回		当前窗口显示属性
	void	ZWcursor	获取当前窗口光标位置
		参数	int*	光标行返回区指针(窗口内相对坐标, 0起)
			int*	光标列返回区指针(窗口内相对坐标, 0起)
	void	ZWlocate	设置当前窗口光标位置
		参数	int	当前窗口光标行(窗口内相对坐标, 0起)
			int	当前窗口光标列(窗口内相对坐标, 0起)
	void	ZWscroll	滚动当前窗口行
		参数	int	滚动行数(>0上滚, <0下滚, =0清空)
	void	ZWclear 	清除当前窗口内的行
		参数	int	起始行(窗口内相对坐标, 0起)
			int	行数(完整落于当前窗口内, 0表示剩余全部)
	void	ZWprint 	在当前窗口指定位置显示定长字符串
		参数	int	待显示行(窗口内相对坐标, 0起)
			int	待显示列(窗口内相对坐标, 0起)
			char*	待显示字符串指针
			int	待显示字符串长度
	void	ZWprintf	在当前窗口指定位置显示格式化信息
		参数	int	待显示行(窗口内相对坐标, 0起)
			int	待显示列(窗口内相对坐标, 0起)
			char*	格式化信息指针(同printf, 转换后<1024字节)
			...
	void	ZWline		在当前窗口指定行以指定方式显示字符串
		参数	int	待显示行(窗口内相对坐标, 0起)
			int	待显示方式(显示位置类常数)
			char*	待显示字符串指针
	void	ZWbox		在当前窗口指定位置以指定属性显示边框
		参数	int	边框起始行(窗口内相对坐标, 0起)
			int	边框起始列(窗口内相对坐标, 0起)
			int	边框高度(完整落于窗口内)
			int	边框宽度(完整落于窗口内)
			int	边框属性(显示属性类常数)
按钮类
	void	ZBdisplay	显示一组按钮~
		参数	ZBUTTON*按钮组指针
			int	按钮数(>0)
	void	ZBclear 	清除一组按钮的显示~
		参数	ZBUTTON*按钮组指针
			int	按钮数(>0)
	void	ZBhit   	弹动一按钮~
				等价于按下一按钮随后弹起
		参数	ZBUTTON*待弹动按钮指针
	void	ZBpress 	按下一按钮~
		参数	ZBUTTON*待按下按钮指针
	void	ZBrelease	弹起一按钮~
		参数	ZBUTTON*待弹起按钮指针
	void	ZBkey   	检查一键码是否满足按钮键码~
		参数	ZBUTTON*按钮组指针
			int	按钮数(>0)
			int	待查键码(标准键码(参见键码类常数)或ASCII字符)
				ASCII字符可为小写
		返回	-1	不满足任何按钮键码
			其他	所满足按钮号(0起)
字段类
	int	ZFroundpos	避免指定位置落在半个象形文字上(前调整)~
		参数	char*	待检测字符串指针
			int	指定的偏移量
		返回		调整后的偏移量
	int	ZFfixpic	检查格式控制字符是否固定格式符~
		参数	char*	格式控制字符串指针
			int	偏移量
		返回	0	不是
	void	ZFtotext	将字段值依照格式控制字符串转换为文本格式~
		参数	ZFIELD*	字段指针
			char*	文本格式缓冲区指针
	void	ZFtodata	将文本格式去除格式控制字符串转换为字段值~
		参数	ZFIELD*	字段指针
			char*	文本格式缓冲区指针
	void	ZFattr		设置字段显示属性~
		参数	ZFIELD*	字段指针
			int	字段状态(参见字段状态类常数)
	void	ZFdisplay	显示一组字段~
		参数	ZFIELD*	字段组指针
			int	字段数(>0)
			int	字段状态(参见字段状态类常数)
		返回	0	成功
===============================================================================