zlib.doc

unix下的界面工具

===============================================================================
                              ZLIB 1.0 版使用说明
===============================================================================

注: 1.	~标志为库函数内部使用, 应用层应避免使用。

------------------
第一部分  公用常数
------------------
屏幕定义类
	Z_SCR_LINES	屏幕行数~
	Z_SCR_COLS	屏幕列数~
窗口定义类
	ZW_DEFAULT	缺省窗口(无边框不翻转)
	ZW_BOX  	有边框窗口(或运算)
	ZW_REVERSE	翻转显示窗口(或运算)
菜单快捷键
	ZM_HOTKEY	菜单项首字节为快捷键(与菜单项类型或)
显示属性类
	ZA_TEXT 	正文属性(确省)~
	ZA_KEY  	快捷键属性~
	ZA_FIELD	字段属性~
	ZA_EDIT 	编辑属性~
	ZA_BUTTON	按钮属性~
	ZA_FRAME	边框属性~
	ZA_SELBAR	选择光条属性~
	ZA_HOLD 	按钮按下属性~
	ZA_NEGTXT	负值正文属性~
	ZA_NEGFLD	负值字段属性~
	ZA_NEGEDT	负值编辑属性~
字段状态类
	ZF_DISPLAY	显示状态~
	ZF_NORMAL	待编辑状态~
	ZF_EDIT 	编辑中状态~
显示位置类
	ZJ_LEFT 	左对齐显示
	ZJ_RIGHT	右对齐显示
	ZJ_CENTER	对中显示
刷新控制类
	ZI_CURSOR	刷新当前行
	ZI_PAGE 	刷新当前页
	ZI_FIRST	跳转至首页
	ZI_LAST 	跳转至末页
菜单项功能类
	ZM_EXIT 	退出项(退出当前菜单)
	ZM_NULL 	空项(不可定位选择)
	ZM_COMMAND	命令项(参数字段指明命令行)
	ZM_FUNC 	函数项(参数字段指明函数地址)
	ZM_MENU 	菜单项(参数字段指明菜单结构)
	ZM_POPUP	弹出项(参数字段指明弹出式菜单结构)
键码类
    可用键码一览表
	TAB     	BACK_SPACE	SPACE_BAR	ESC
	ENTER
	HOME    	END     	PGUP    	PGDN
	UP      	DOWN    	RIGHT   	LEFT
	INS     	DEL
	CTRL_A  	CTRL_B  	CTRL_C  	CTRL_D
	CTRL_E  	CTRL_F  	CTRL_G  	CTRL_H
	CTRL_I  	CTRL_J  	CTRL_K  	CTRL_L
	CTRL_M  	CTRL_N  	CTRL_O  	CTRL_P
	CTRL_Q  	CTRL_R  	CTRL_S  	CTRL_T
	CTRL_U  	CTRL_V  	CTRL_W  	CTRL_X
	CTRL_Y  	CTRL_Z
	F1      	F2      	F3      	F4
------------------
第二部分  公用结构
------------------
按钮(ZBUTTON)
	int	r	起始行(窗口内相对坐标, 0起, 非法值用于屏蔽显示)
	int	c	起始列(窗口内相对坐标, 0起, 非法值用于屏蔽显示)
	int	h	高度(完整落于窗口内, 非法值用于屏蔽显示)
	int	w	宽度(完整落于窗口内, 非法值用于屏蔽显示)
	char	*l	标签(左对齐显示于按钮最下行)
	int	k	键码(标准键码(参见键码类常数)或ASCII字符或0(表示任意))
			ASCII字符应使用大写
	int	(*v)()	按动合法性检查函数(0无)
			返回0可按动, -1不可按动
			合法性检查函数的参数项为
			int	k	键码
			int	n	按钮组内序号(0起)
	void	(*p)()	按动处理函数(0无)
			返回0按动有效, -1按动无效
			按动有效时导致退出屏幕处理器, 其返回码为该按钮键码
			按动处理函数的参数项为
			int	k	键码
			int	n	按钮组内序号(0起)
字段(ZFIELD)
	int	r	所在行(窗口内相对坐标, 0起, 非法值用于屏蔽显示)
	int	c	起始列(窗口内相对坐标, 0起, 非法值用于屏蔽显示)
	char	t	字段类型(C字符/S字符串/I整数/L长整数/F浮点/D双精度)
	int	w	显示宽度(完整落于窗口内)
	int	d	小数位数(0无)
	char	*p	编辑控制格式(0无)
			对于带有小数位的浮点及双精度字段, 该项不可省略
			0		十进制数字
			9		十进制数字, 负号
			a/A		字母/自动转为大写
			n/N		字母或十进制数字/自动转为大写
			h/H		十六进制数字/自动转为大写
			空格,无,x/X	任意字符/自动转为大写
			其它非字母字符	不可编辑之固定位置
			日期型字段使用"0000年00月00日"
	void	*v	字段值域指针
	int	(*b)()	编辑前处理函数(0无)
			返回0允许进入编辑, -1禁止进入编辑
			编辑前处理函数的参数项为
			ZFIELD	*f	当前字段结构指针
			int	n	字段组内序号(0起)
	int	(*a)()	编辑后处理函数(0无)
			返回0允许离开编辑, -1禁止离开编辑
			编辑后处理函数的参数项为
			int	k	激活该函数的键码
			ZFIELD	*f	当前字段结构指针
			int	n	字段组内序号(0起)
屏幕(ZSCREEN)
	int	bc	屏幕内按钮数(>0)
	ZBUTTON	*bs	屏幕内按钮组指针
			按钮组内至少应有一个按钮的弹起处理函数能返回0
	int	fc	屏幕内字段数(0无)
	ZFIELD	*fs	屏幕内字段组指针(0无)
	int	(*nk)()	空闲(无击键时)处理函数
			返回非零值为等价键码, 等价于按下该键, 屏幕处理器将自动
			调用其对应按钮的弹起处理函数
			空闲处理函数无参数项
浏览源(ZBROWSE)
	int	wr	浏览窗口起始行(绝对坐标, 0起)
	int	wc	浏览窗口起始列(绝对坐标, 0起)
	int	ww	浏览窗口宽度(完整落于屏幕内)
	int	wh	浏览窗口高度(完整落于屏幕内)
	int	ws	浏览窗口类别(参见窗口定义类常数)
	char	*wt	浏览窗口标题指针(0或""无标题)
	ZSCREEN	*s	浏览窗口之屏幕指针
	int	rr	纵向数据项显示数(>0)
	int	rc	横向数据项显示数(>0)
	int	lc	当前屏幕上的数据项数(只读)
	int	cl	当前光标所在的数据项(0起)
	void	(*ds)()	浏览窗口创建初始函数(0无, 一般用于显示屏幕静态内容)
			该函数在浏览窗口打开成功后立即被调用
			浏览窗口创建初始函数无参数项
	int	(*nr)()	无数据项处理函数(0无)
			返回非零值为等价键码, 导致以该键码退出浏览器
			该函数在浏览窗口建立前被调用
			无数据项处理函数无参数项
	int	(*ur)()	唯一数据项处理函数(0无)
			返回非零值为等价键码, 导致以该键码退出浏览器
			该函数在浏览窗口建立前被调用
			唯一数据项处理函数无参数项
	int	(*gl)()	非空数据项处理函数(可提取数据用于快速浏览, 0无)
			返回0成功, -1失败
			非空数据项处理函数参数项为
			int	n	待处理之数据项序号(0起)
	void	(*el)()	空数据项处理函数(可清空数据用于快速浏览, 0无)
			空数据项处理函数参数项为
			int	n	待处理之数据项序号(0起)
	void	(*dl)()	显示一数据项处理函数(0无)
			显示一数据项处理函数参数项为
			int	n	待显示之数据项序号(0起)
	int	(*sl)()	跳转至某一数据项处理函数(0无)
			返回0成功, -1失败
			跳转到某一数据项处理函数参数项为
			int	n	待跳转到之数据项序号(0起)
	int	(*fl)()	跳转至首数据项处理函数(0无)
			返回0成功, -1失败
			跳转到首数据项处理函数无参数项
	int	(*ll)()	跳转至末数据项处理函数(0无)
			返回0成功, -1失败
			跳转至末数据项处理函数无参数项
	int	(*pl)()	跳转至上一数据项处理函数(0无)
			返回0成功, -1失败
			跳转至上下一数据项处理函数无参数项
	int	(*nl)()	跳转至下一数据项处理函数(0无)
			返回0成功, -1失败
			跳转至下一数据项处理函数无参数项
	int	st	内部刷新处理函数控制码(只写, 参见刷新控制类常数)
	void	(*cc)()	光标项改变处理函数(0无)
			光标项改变处理函数无参数项
	int	(*dc)()	数据变化检查函数(一般用于多用户环境并发处理, 0无)
			返回0数据源已变化, -1数据源无变化
			数据变化检查函数无参数项
菜单项(ZMTERM)
	char	*d	菜单项名称指针
			如果在菜单项类型中定义了快捷键, 则首字符即作为快捷键
	int	t	菜单项类型(参见菜单项功能类常数)
			定义快捷键, 只需或运算菜单项常数
	void	*p	菜单项参数指针(参见菜单项功能类常数)
菜单(ZMENU)
	int	r	菜单窗口起始行(绝对坐标, 0起)
	int	c	菜单窗口起始列(绝对坐标, 0起)
	int	s	菜单窗口类别(参见窗口定义类常数)
	char	*t	菜单窗口标题指针(0或""无标题)
	int	h	菜单项显示行数(>0)
	int	w	菜单项显示列数(>0)
	ZMTERM	*p	菜单项结构指针
------------------
第三部分  公用函数
------------------
杂项类
	int	Zinit   	专用环境初始化
				包括初始化屏幕、颜色、忽略信号处理、初始化缺省
				窗口等
		返回	0	成功
	void	Zexit   	专用环境终止化
				关闭所有打开的窗口并撤消由初始化所做的一切改变
	int	Zideocode	检查中文代码~
		参数	int	待检查的代码
		返回	0	不是中文代码
			其它	是中文代码