menu.h

linux内核

/* -*- c -*- ------------------------------------------------------------- *
 *
 *   Copyright 2004-2005 Murali Krishnan Ganapathy - All Rights Reserved
 *
 *   This program is free software; you can redistribute it and/or modify
 *   it under the terms of the GNU General Public License as published by
 *   the Free Software Foundation, Inc., 53 Temple Place Ste 330,
 *   Boston MA 02111-1307, USA; either version 2 of the License, or
 *   (at your option) any later version; incorporated herein by reference.
 *
 * ----------------------------------------------------------------------- */

/* This program can be compiled for DOS with the OpenWatcom compiler
 * (http://www.openwatcom.org/):
 *
 * wcl -3 -osx -mt <filename>.c
 */

#ifndef __MENU_H__
#define __MENU_H__

#include "com32io.h"
#include "tui.h"
#include "syslnx.h"
#include "scancodes.h"
#include <string.h>

// TIMEOUT PARAMETERS
/* If no key is pressed within TIMEOUTNUMSTEPS * TIMEOUTSTEPSIZE milliseconds
   and if a timeout handler is registered, then that will be called.
   The handler should either either take control from there on, or return without
   producing any change in the current video settings.

   For e.g. the handler could
   * Could just quit the menu program
   * beep and return.

   TIMEOUTSTEPSIZE is the interval for which the program sleeps without checking for 
   any keystroke. So increasing this will make the response of the system slow.
   Decreasing this will make a lot of interrupt calls using up your CPU. Default
   value of TIMEOUTSTEPSIZE of 0.1 seconds should be right in most cases.

   TIMEOUTNUMSTEPS of 3000 corresponds to a wait time of 300 seconds or 5 minutes
*/

#define TIMEOUTSTEPSIZE 10  
#define TIMEOUTNUMSTEPS 30000L

// Attributes
#define NORMALATTR    0x17
#define NORMALHLITE   0x1F // Normal Highlight attribute
#define REVERSEATTR   0x70
#define REVERSEHLITE  0x78 // Reverse Hightlight attribute
#define INACTATTR     0x18
#define INACTHLITE    0x10 // Inactive Highlight attribute
#define REVINACTATTR  0x78
#define REVINACTHLITE 0x70 // Reverse Inactive Highlight attr

#define STATUSATTR    0x74
#define STATUSHLITE   0x7B // Status highlight

#define FILLCHAR      177
#define FILLATTR      0x01
#define SHADOWATTR    0x00
#define SPACECHAR     ' '

#define TFILLCHAR     ' '
#define TITLEATTR     0x70

#define ENABLEHLITE   '<' // Char which turns on highlight
#define DISABLEHLITE  '>' // Char which turns off highlight
#define NOHLITE       0   // The offset into attrib array for non-hilite
#define HLITE         1   // The offset for Hlite attrib

#define MOREABOVE    24 // char to print when more menu items available above
#define MOREBELOW    25 // more items available below
#define SCROLLBOX    176 // Filled char to display

// Attributes of the menu system
#define MAXMENUS      10 // Maximum number of menu's allowed
#define MAXMENUSIZE   30 // Default value for max num of entries in each menu
#define MAXMENUHEIGHT 14 // Maximum number of entries displayed
#define MENUBOXTYPE   BOX_SINSIN // Default box type Look at tui.h for other values

// Upper bounds on lengths
// We copy the given string, so user can reuse the space used to store incoming arguments.
#define MENULEN       40 // Each menu entry is atmost MENULEN chars
#define STATLEN       80 // Maximum length of status string
#define TITLELEN       80 // Maximum length of title string
#define ACTIONLEN     255 // Maximum length of an action string

// Layout of menu
#define MENUROW       3  // Row where menu is displayed (relative to window)
#define MENUCOL       4  // Col where menu is displayed (relative to window)
#define MENUPAGE      1  // show in display page 1
#define HELPPAGE      2  // Use this page for any additional information
#define STATLINE      24 // Line number where status line starts (relative to window)

// Used for printing debugging messages
#define DEBUGLINE     23  // debugging info goes here

// Other Chars
#define SUBMENUCHAR   175 // This is >> symbol
#define RADIOMENUCHAR '>' // > symbol for radio menu? 
#define EXITMENUCHAR  174 // This is << symbol
#define CHECKED       251 // Check mark
#define UNCHECKED     250 // Light bullet
#define RADIOSEL      '.' // Current Radio Selection 
#define RADIOUNSEL    ' ' // Radio option not selected

typedef unsigned char uchar;

// Types of menu's
#define NORMALMENU 1 
#define RADIOMENU  2

typedef enum {OPT_INACTIVE, OPT_SUBMENU, OPT_RUN, OPT_EXITMENU, OPT_CHECKBOX,
	      OPT_RADIOMENU, OPT_SEP, OPT_INVISIBLE,
	      OPT_RADIOITEM} t_action;

typedef union {
  uchar submenunum; // For submenu's
  uchar checked; // For check boxes
  uchar radiomenunum; // Item mapping to a radio menu
} t_itemdata;

struct s_menuitem;
struct s_menu;
struct s_menusystem;

typedef struct {
   unsigned int valid :1; // Is action valid?
   unsigned int refresh:1; // Should we recompute menu stuff?
   unsigned int reserved:6; // For future expansion
} t_handler_return;

t_handler_return ACTION_VALID,ACTION_INVALID; // Specific values 

typedef t_handler_return (*t_item_handler)(struct s_menusystem *, struct s_menuitem *);
typedef void (*t_menusystem_handler)(struct s_menusystem *, struct s_menuitem *);
typedef void (*t_keys_handler)(struct s_menusystem *, struct s_menuitem *,
              unsigned int scancode); 
    // Last parameter = HIGH BYTE = scan code , LOW BYTE = ASCII CODE

typedef enum {HDLR_SCREEN, HDLR_KEYS } t_handler; 
// Types of handlers for menu system 

// TIMEOUT is the list of possible values which can be returned by the handler
// instructing the menusystem what to do. The default is CODE_WAIT
typedef enum {CODE_WAIT, CODE_ENTER, CODE_ESCAPE } TIMEOUTCODE;
typedef TIMEOUTCODE (*t_timeout_handler)(void);

typedef struct s_menuitem {
  char *item;
  char *status;
  char *data; // string containing kernel to run.. but... 
  // for radio menu's this is a pointer to the item selected or NULL (initially)
  void * extra_data; // Any other data user can point to
  t_item_handler handler; // Pointer to function of type menufn
  t_action action;
  t_itemdata itemdata; // Data depends on action value
  unsigned int helpid; // context sensitive help system ID
  uchar shortcut; // one of [A-Za-z0-9] shortcut for this menu item
  uchar index; // Index within the menu array
  uchar parindex; // Index of the menu in which this item appears. 
} t_menuitem;

typedef t_menuitem *pt_menuitem; // Pointer to type menuitem

typedef struct s_menu {
  pt_menuitem *items; // pointer to array of pointer to menuitems
  char *title;
  int maxmenusize; // the size of array allocated
  uchar numitems; // how many items do we actually have
  uchar menuwidth;
  uchar row,col; // Position where this menu should be displayed
  uchar menuheight; // Maximum number of items to be displayed
} t_menu;

typedef t_menu *pt_menu; // Pointer to type menu

typedef struct s_menusystem {
  pt_menu menus[MAXMENUS];
  char *title; 
  t_menusystem_handler handler; // Menu system handler 
  t_keys_handler keys_handler; // Handler for unknown keys
  t_timeout_handler ontimeout; // Timeout handler
  unsigned long tm_numsteps; 
  // Time to wait for key press=numsteps * stepsize milliseconds
  unsigned int tm_stepsize; // Timeout step size (in milliseconds)

  int maxmenuheight;
  uchar nummenus;
  uchar normalattr[2]; // [0] is non-hlite attr, [1] is hlite attr
  uchar reverseattr[2];
  uchar inactattr[2];
  uchar revinactattr[2];
  uchar statusattr[2];
  uchar fillchar;
  uchar fillattr;
  uchar spacechar;
  uchar tfillchar;
  uchar titleattr;
  uchar shadowattr;
  uchar statline;
  uchar menupage;
  uchar maxrow,minrow,numrows; // Number of rows in the window 
  uchar maxcol,mincol,numcols; // Number of columns in the window

  // Menu box look
  boxtype menubt; // What type of boxes should be drawn 
  char box_horiz,box_ltrt,box_rtlt; // Some chars of the box, for redrawing portions of the box

} t_menusystem;

typedef t_menusystem *pt_menusystem; // Pointer to type menusystem

/************************************************************************
 * IMPORTANT INFORMATION
 *
 * All functions which take a string as argument store the pointer
 * for later use. So if you have alloc'ed a space for the string
 * and are passing it to any of these functions, DO NOT deallocate it.
 *
 * If they are constant strings, you may receive warning from the compiler
 * about "converting from char const * to char *". Ignore these errors.
 *
 * This hack/trick of storing these pointers will help in reducing the size
 * of the internal structures by a lot.
 *
 ***************************************************************************
 */

pt_menuitem showmenus(uchar startmenu);

pt_menusystem init_menusystem(const char *title); 
void close_menusystem(); // Deallocate memory used

void set_normal_attr(uchar normal, uchar selected, uchar inactivenormal, uchar inactiveselected);

void set_normal_hlite(uchar normal, uchar selected, uchar inactivenormal, uchar inactiveselected);

void set_status_info(uchar statusattr, uchar statushlite, uchar statline);

void set_title_info(uchar tfillchar, uchar titleattr);

void set_misc_info(uchar fillchar, uchar fillattr,uchar spacechar, uchar shadowattr);
void set_box_type(boxtype bt);

void set_window_size(uchar top, uchar left, uchar bot, uchar right); // Set the window which menusystem should use

void set_menu_options(uchar maxmenuheight); 
// maximum height of a menu

void reg_handler(t_handler htype, void * handler); // Register handler

void unreg_handler( t_handler htype); 

void reg_ontimeout(t_timeout_handler, unsigned int numsteps, unsigned int stepsize); 
// Set timeout handler, set 0 for default values.
// So stepsize=0 means numsteps is measured in centiseconds.
void unreg_ontimeout();

// Create a new menu and return its position
uchar add_menu(const char *title, int maxmenusize); 

void set_menu_pos(uchar row,uchar col); // Set the position of this menu.

// Add item to the "current" menu 
pt_menuitem add_item(const char *item, const char *status, t_action action, const char *data, uchar itemdata);

// Set shortcut key and help id
void set_item_options(uchar shortcut,int helpid);

// Set the shortcut key for the current item
static inline void set_shortcut(uchar shortcut) 
{ 
  set_item_options(shortcut,0xFFFF);
}

// Add a separator to the "current" menu
pt_menuitem add_sep();

// Main function for the user's config file
int menumain(char *cmdline);

#endif