/[LeafOK_CVS]/lbbs/include/menu.h
ViewVC logotype

Annotation of /lbbs/include/menu.h

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.32 - (hide annotations)
Tue Nov 4 13:49:50 2025 UTC (4 months, 1 week ago) by sysadm
Branch: MAIN
Changes since 1.31: +7 -15 lines
Content type: text/x-chdr
Update file header information comments

1 sysadm 1.32 /* SPDX-License-Identifier: GPL-3.0-or-later */
2     /*
3     * menu
4     * - configurable user interactive menu feature
5     *
6     * Copyright (C) 2004-2025 by Leaflet <leaflet@leafok.com>
7     */
8 sysadm 1.1
9 sysadm 1.7 #ifndef _MENU_H_
10     #define _MENU_H_
11    
12 sysadm 1.26 #include "bbs_cmd.h"
13 sysadm 1.11 #include "common.h"
14 sysadm 1.15 #include "trie_dict.h"
15 sysadm 1.16 #include <stdint.h>
16 sysadm 1.11
17 sysadm 1.20 #define MAX_MENU_NAME_LENGTH 30
18 sysadm 1.21 #define MAX_ITEMS_PER_MENU 256
19 sysadm 1.20 #define MAX_MENUITEM_NAME_LENGTH 256
20 sysadm 1.29 #define MAX_MENUITEM_TEXT_LENGTH 200
21 sysadm 1.20 #define MAX_MENUITEM_ACTION_LENGTH 30
22 sysadm 1.29 #define MAX_MENUTITLE_TEXT_LENGTH 100
23 sysadm 1.16 #define MAX_MENU_SCR_NAME_LENGTH 20
24     #define MAX_MENU_SCR_BUF_LENGTH 2000
25 sysadm 1.9 #define MAX_MENUS 256
26 sysadm 1.16 #define MAX_MENUITEMS 5120
27 sysadm 1.9 #define MAX_MENU_DEPTH 50
28 sysadm 1.1
29 sysadm 1.16 typedef uint64_t MENU_ID;
30     typedef uint64_t MENU_ITEM_ID;
31     typedef uint64_t MENU_SCREEN_ID;
32    
33 sysadm 1.14 struct menu_item_t
34 sysadm 1.5 {
35 sysadm 1.17 int16_t row, col;
36 sysadm 1.20 char action[MAX_MENUITEM_ACTION_LENGTH];
37 sysadm 1.16 MENU_ID action_menu_id;
38 sysadm 1.18 bbs_cmd_handler action_cmd_handler;
39 sysadm 1.17 int8_t submenu;
40 sysadm 1.16 int priv, level;
41 sysadm 1.20 char name[MAX_MENUITEM_NAME_LENGTH];
42     char text[MAX_MENUITEM_TEXT_LENGTH];
43 sysadm 1.1 };
44 sysadm 1.14 typedef struct menu_item_t MENU_ITEM;
45 sysadm 1.2
46 sysadm 1.14 struct menu_title_t
47 sysadm 1.5 {
48 sysadm 1.16 int16_t row, col;
49     int8_t show;
50 sysadm 1.20 char text[MAX_MENUTITLE_TEXT_LENGTH];
51 sysadm 1.2 };
52 sysadm 1.14 typedef struct menu_title_t MENU_TITLE;
53 sysadm 1.2
54 sysadm 1.14 struct menu_screen_t
55 sysadm 1.5 {
56 sysadm 1.16 char name[MAX_MENU_SCR_NAME_LENGTH];
57     int64_t buf_offset;
58     int64_t buf_length;
59 sysadm 1.2 };
60 sysadm 1.14 typedef struct menu_screen_t MENU_SCREEN;
61 sysadm 1.1
62 sysadm 1.14 struct menu_t
63 sysadm 1.5 {
64 sysadm 1.20 char name[MAX_MENU_NAME_LENGTH];
65 sysadm 1.9 MENU_TITLE title;
66 sysadm 1.19 char screen_name[MAX_MENU_SCR_NAME_LENGTH];
67 sysadm 1.16 MENU_SCREEN_ID screen_id;
68     int8_t screen_show;
69     int16_t screen_row, screen_col;
70     MENU_ITEM_ID items[MAX_ITEMS_PER_MENU];
71     int16_t item_count;
72 sysadm 1.21 int16_t page_row, page_col;
73     int16_t page_item_limit;
74 sysadm 1.24 int8_t use_filter;
75     bbs_cmd_handler filter_handler;
76 sysadm 1.1 };
77 sysadm 1.14 typedef struct menu_t MENU;
78 sysadm 1.1
79 sysadm 1.14 struct menu_set_t
80 sysadm 1.5 {
81 sysadm 1.16 int shmid;
82     void *p_reserved;
83     void *p_menu_pool;
84     void *p_menu_item_pool;
85     void *p_menu_screen_pool;
86     char *p_menu_screen_buf;
87     char *p_menu_screen_buf_free;
88     int16_t menu_count;
89     int16_t menu_item_count;
90     int16_t menu_screen_count;
91 sysadm 1.15 TRIE_NODE *p_menu_name_dict;
92 sysadm 1.16 TRIE_NODE *p_menu_screen_dict;
93     MENU_ID menu_id_path[MAX_MENU_DEPTH];
94     int16_t menu_item_pos[MAX_MENU_DEPTH];
95     int16_t choose_step;
96 sysadm 1.17 int8_t menu_item_display[MAX_ITEMS_PER_MENU];
97     int16_t menu_item_r_row[MAX_ITEMS_PER_MENU];
98     int16_t menu_item_r_col[MAX_ITEMS_PER_MENU];
99 sysadm 1.21 int16_t menu_item_page_id[MAX_ITEMS_PER_MENU];
100 sysadm 1.27 int8_t allow_exit;
101 sysadm 1.2 };
102 sysadm 1.14 typedef struct menu_set_t MENU_SET;
103 sysadm 1.5
104 sysadm 1.28 extern MENU_SET bbs_menu;
105 sysadm 1.30 extern MENU_SET top10_menu;
106 sysadm 1.4
107 sysadm 1.9 extern int load_menu(MENU_SET *p_menu_set, const char *conf_file);
108 sysadm 1.16 extern int unload_menu(MENU_SET *p_menu_set);
109    
110 sysadm 1.27 extern int get_menu_shm_readonly(MENU_SET *p_menu_set);
111 sysadm 1.22 extern int set_menu_shm_readonly(MENU_SET *p_menu_set);
112     extern int detach_menu_shm(MENU_SET *p_menu_set);
113 sysadm 1.16
114 sysadm 1.23 extern int display_menu_cursor(MENU_SET *p_menu_set, int show);
115 sysadm 1.16 extern int menu_control(MENU_SET *p_menu_set, int key);
116     extern int display_menu(MENU_SET *p_menu_set);
117    
118     inline MENU *get_menu(MENU_SET *p_menu_set, const char *menu_name)
119     {
120     MENU *value = NULL;
121 sysadm 1.10
122 sysadm 1.16 trie_dict_get(p_menu_set->p_menu_name_dict, menu_name, (int64_t *)&value);
123 sysadm 1.10
124 sysadm 1.16 return ((MENU *)value);
125     }
126 sysadm 1.10
127 sysadm 1.16 inline MENU *get_menu_by_id(MENU_SET *p_menu_set, MENU_ID menu_id)
128     {
129     if (menu_id < 0 || menu_id >= p_menu_set->menu_count)
130     {
131     return NULL;
132     }
133    
134 sysadm 1.31 return (MENU *)((char *)(p_menu_set->p_menu_pool) + sizeof(MENU) * menu_id);
135 sysadm 1.16 }
136    
137     inline MENU_ITEM *get_menu_item_by_id(MENU_SET *p_menu_set, MENU_ITEM_ID menu_item_id)
138     {
139     if (menu_item_id < 0 || menu_item_id >= p_menu_set->menu_item_count)
140     {
141     return NULL;
142     }
143 sysadm 1.10
144 sysadm 1.31 return (MENU_ITEM *)((char *)(p_menu_set->p_menu_item_pool) + sizeof(MENU_ITEM) * menu_item_id);
145 sysadm 1.16 }
146 sysadm 1.10
147 sysadm 1.16 inline MENU_SCREEN *get_menu_screen_by_id(MENU_SET *p_menu_set, MENU_SCREEN_ID menu_screen_id)
148     {
149     if (menu_screen_id < 0 || menu_screen_id >= p_menu_set->menu_screen_count)
150     {
151     return NULL;
152     }
153 sysadm 1.10
154 sysadm 1.31 return (MENU_SCREEN *)((char *)(p_menu_set->p_menu_screen_pool) + sizeof(MENU_ITEM) * menu_screen_id);
155 sysadm 1.16 }
156 sysadm 1.4
157 sysadm 1.7 #endif //_MENU_H_

webmaster@leafok.com
ViewVC Help
Powered by ViewVC 1.3.0-beta1