curlib.h

用C语言实现的字符型的菜单界面

 *           short sx - 开始列.
 *           short row - 列.
 *           short col - 行.
 *           chtype attr  - 颜色.
 * Return  : 
 *           TRUE.
 *----------------------------------------------------------------------------*/
extern int cls(int sy,int sx,int row,int col,chtype attr);
/*----------------------------------------------------------------------------*
 * Function: 用某种颜色清除屏幕的一行.
 * Argument:
 *           short sy - 开始行.
 *           short sx - 开始列.
 *           short len - 长度.
 *           chtype attr  - 颜色.
 * Return  : 
 *           TRUE.
 *----------------------------------------------------------------------------*/
extern int cls_line(int sy,int sx,int len,chtype attr);
/*----------------------------------------------------------------------------*
 * Function: 在屏幕中央显示一个系统消息窗口.
 * Argument:
 *           char *msg - 消息文本.
 * Return  : 
 *           TRUE.
 *----------------------------------------------------------------------------*/
extern int disp_sysbox(char *msg);
/*----------------------------------------------------------------------------*
 * Function: 显示一个消息窗口.
 * Argument:
 *           short sy - 消息框的开始行.
 *           short sx - 消息框的开始列.
 *           char *msg - 消息文本.
 *           char *title - 标题文本.
 *           chtype flag  - MSG_OK, MSG_OC, MSG_YN, MSG_YNC, MSG_RC, MSG_ARI.
 * Return  : 
 *           TRUE.
 *----------------------------------------------------------------------------*/
extern disp_box(uchar sy,uchar sx,char *msg,char *title,chtype flag);
/*----------------------------------------------------------------------------*
 * Function: 在窗口中画一条制表线.
 * Argument:
 *           short sy - 开始行.
 *           short sx - 开始列.
 *           int width - 宽度.
 * Return  : 
 *           TRUE.
 *----------------------------------------------------------------------------*/
extern int draw_line(int sy,int sx,int width);

/****************************************************************************** 
 * <第二章> 输入函数.                                                         *
 ******************************************************************************/
/*----------------------------------------------------------------------------*
 * FUNCTION: Get a Char from keybord. No wait.
 * Argument:
 *           None.
 * Return  : 
 *           > 0 - If You Press Key.
 *           = 0 - If no key pressed.
 *
 * Notes   : If You Press Cursor_Key,You Must Call get_key() 3 Times.
 *----------------------------------------------------------------------------*/
extern int get_key();
/*----------------------------------------------------------------------------*
 * FUNCTION: Get Char From Keyboard. Wait.
 * Argument:
 *           None.
 * Return  : 
 *           > 0 - If You Press Key.
 *
 * Notes   : If No Key Press, Wait Until Key Pressed.
 *----------------------------------------------------------------------------*/
extern int get_char();
/*----------------------------------------------------------------------------*
 * FUNCTION: 从(y,x)处得到一个字符并显示.
 * Argument:
 *           y - 开始行.
 *           x - 开始列.
 * Return  : 
 *           输入字符.
 * 说    明:
 *----------------------------------------------------------------------------*/
extern int mvget_char(int y,int x);
/*----------------------------------------------------------------------------*
 * Function: Get function key from Keyboard, Wait.
 * Argument:
 *           unsigned char *c - Get char.
 * Return  : 
 *           0 - if you press other Key,and 'c' is the key by pressed.
 *           Funckey - if you press special key,and c=0. 
 *----------------------------------------------------------------------------*/
extern int get_funckey(unsigned char *c);
/*----------------------------------------------------------------------------*
 * Function: 从键盘读一串 
 * Argument:
 *   sy     : 屏幕位置的横坐标;
 *   sx     : 屏幕位置的纵坐标;
 *   strbuf : 读取的字串存放地址;
 *   col    : 读取的字串的长度;
 *   fid    : 读取的字串的特性;
 *            = 0 :<字符限定表>为空串时  ,不显示, 接受任意字符;
 *                 <字符限定表>为非空串时,显示<字符限定表>的首字符,接受任意字符;
 *            = 1 :   显示, 接受数字字符;
 *            = 2 :   显示, 接受字母字符;
 *            = 3 :   显示, 接受数字加字母字符;
 *            = 4 :   显示, 接受任何字符;
 *            = 5 :   显示, 仅接受指定<字符表>上的字符;
 *            = 6 :   显示, 不接受任意字符;
 *
 *            = 11: 和=1同, 但要求读满所需长度才能返回;
 *            = 12: 和=2同, 但要求读满所需长度才能返回;
 *            = 13: 和=3同, 但要求读满所需长度才能返回;
 *            = 14: 和=4同, 但要求读满所需长度才能返回;
 *            = 15: 和=5同, 但要求读满所需长度才能返回;
 *
 *            =-11: 和=11同, 但要求读满所需长度才能返回;
 *                  <字符限定表>为空串时  ,不显示;
 *                  <字符限定表>为非空串时,显示'*';
 *            =-12: 和=12同, 但要求读满所需长度才能返回;
 *                  <字符限定表>为空串时  ,不显示;
 *                  <字符限定表>为非空串时,显示'*';
 *            =-13: 和=13同, 但要求读满所需长度才能返回;
 *                  <字符限定表>为空串时  ,不显示;
 *                  <字符限定表>为非空串时,显示'*';
 *            =-14: 和=14同, 但要求读满所需长度才能返回;
 *                  <字符限定表>为空串时  ,不显示;
 *                  <字符限定表>为非空串时,显示'*';
 *            =-15: 和=15同, 但要求读满所需长度才能返回;
 *                  <字符限定表>为空串时  ,不显示;
 *                  <字符限定表>为非空串时,显示'*';
 *   ctable : 无条件接受字串的<字符限定表>;
 *
 *   返回值:
 *          0: 被向左箭头移出最左端或移动向上箭头;
 *          1: 被向右箭头移出最右端或移动向下箭头,或
 *             输满所要求长度的字串或按了回车;
 *         -1: 按了 ESC 键;
 *----------------------------------------------------------------------------*/
extern int getline(int sy,int sx,char *strbuf,int col,int fid,char *ctable);
/*-------------------------------------------------------------
 * FUNCTION: 从键盘读一串 
 *
 *   变量定义与上getlinen相同,但返回值不同:
 *
 *   返回值:
 *         -1: 按了 ESC 键;
 *          0: 被向左箭头移出最左端;
 *          1: 移动向上箭头;
 *          2: 被向右箭头移出最右端;
 *          3: 移动向下箭头;
 *          4: 按了回车;
 *          5: 输满所要求长度的字串;
 *-------------------------------------------------------------*/
extern int getlineg(int sy,int sx,char *strbuf,int col,int fid,char *ctable);
/*----------------------------------------------------------------------------*
 * FUNCTION: 从键盘读一整数 
 *  变量定义:
 *   y      : 屏幕位置的横坐标;
 *   x      : 屏幕位置的纵坐标;
 *   int  * : 读取的整数存放地址;
 *   len    : 读取的整数的长度;
 *   返回值:
 *          0: 被向左箭头移出最左端或移动向上箭头;
 *          1: 被向右箭头移出最右端或移动向下箭头,或
 *             输满所要求长度的字串或按了回车;
 *         -1: 按了 ESC 键;
 *----------------------------------------------------------------------------*/
extern get_int(int y,int x,int *intbuf,int len);
/*----------------------------------------------------------------------------*
 * FUNCTION: 从键盘读一长整数 
 *  变量定义:
 *   y      : 屏幕位置的横坐标;
 *   x      : 屏幕位置的纵坐标;
 *   longbuf * : 读取的长整数存放地址;
 *   len    : 读取的长整数的长度;
 *   返回值:
 *          0: 被向左箭头移出最左端或移动向上箭头;
 *          1: 被向右箭头移出最右端或移动向下箭头,或
 *             输满所要求长度的字串或按了回车;
 *         -1: 按了 ESC 键;
 *----------------------------------------------------------------------------*/
extern get_long(int x,int y,long *longbuf,int len);
/*----------------------------------------------------------------------------*
 * FUNCTION: 从键盘读一浮点数 
 *  变量定义:
 *   y      : 屏幕位置的横坐标;
 *   x      : 屏幕位置的纵坐标;
 *   doublebuf* : 读取的浮点数存放地址;
 *   len    : 读取的长度;
 *   dec    : 小数点后位数;
 *
 *   返回值:
 *          0: 被向左箭头移出最左端或移动向上箭头;
 *          1: 被向右箭头移出最右端或移动向下箭头,或
 *             输满所要求长度的字串或按了回车;
 *         -1: 按了 ESC 键;
 *----------------------------------------------------------------------------*/
extern get_double(int sy,int sx,double *doublebuf,int len,int dec);

/****************************************************************************** 
 * <第三章> 输出函数.                                                         *
 ******************************************************************************/
/*----------------------------------------------------------------------------*
 * FUNCTION: 屏幕特殊显示(带颜色, 按 printf 格式 ) 
 * Argument:
 *           short y - 开始行.
 *           short x - 开始列.
 *	     chtype fcol - 前景色.
 *	     chtype gcol - 背景色.
 *           char *format - 格式.
 *           va_alist - 类似 printf() 的参数形式.
 * Return  : 
 *           TRUE.
 * 说    明:
 *         va_dcl        等同于 int va_alist;
 *         va_list       等同于 char *
 *         va_start(arg) 等同于 arg=(char *)&va_alist  
 *----------------------------------------------------------------------------*/
extern int tprint();
/*----------------------------------------------------------------------------*
 * FUNCTION: 屏幕显示(按 printf 格式 ) 
 * Argument:
 *           short y - 开始行.
 *           short x - 开始列.
 *           char *format - 格式.
 *           va_alist - 类似 printf() 的参数形式.
 * Return  : 
 *           TRUE.
 * 说    明:
 *         va_dcl        等同于 int va_alist;
 *         va_list       等同于 char *
 *         va_start(arg) 等同于 arg=(char *)&va_alist  
 *----------------------------------------------------------------------------*/
extern int sprint();
/*----------------------------------------------------------------------------*
 * FUNCTION: 窗口显示(按 printf 格式 ) 
 * Argument:
 *           WINDOW *win - 窗口.
 *           short y - 开始行.
 *           short x - 开始列.
 *           char *format - 格式.
 *           va_alist - 类似 printf() 的参数形式.
 * Return  : 
 *           TRUE.
 * 说    明:
 *         va_dcl        等同于 int va_alist;
 *         va_list       等同于 char *
 *         va_start(arg) 等同于 arg=(char *)&va_alist  
 *----------------------------------------------------------------------------*/
extern int wsprint();

/****************************************************************************** 
 * <第四章> 其它函数.                                                         *
 ******************************************************************************/
extern void set_tty_attr(void);

#endif