NeoMutt  2025-12-11-860-g80c9cc
Teaching an old dog new tricks
DOXYGEN
Loading...
Searching...
No Matches
menu.c
Go to the documentation of this file.
1
23
29
30#include "config.h"
31#include <stdbool.h>
32#include <stdio.h>
33#include "private.h"
34#include "mutt/lib.h"
35#include "core/lib.h"
36#include "gui/lib.h"
37#include "lib.h"
38#include "color/lib.h"
39#include "expando/lib.h" // IWYU pragma: keep
40#include "key/lib.h"
41#include "module_data.h"
42#include "type.h"
43
44struct ConfigSubset;
45
49static const struct AttrColor *default_color(struct Menu *menu, int line)
50{
52}
53
57static int generic_search(struct Menu *menu, regex_t *rx, int line)
58{
59 struct Buffer *buf = buf_pool_get();
60
61 menu->make_entry(menu, line, -1, buf);
62 int rc = regexec(rx, buf->data, 0, NULL, 0);
63 buf_pool_release(&buf);
64
65 return rc;
66}
67
72void menu_init2(char **search_buffers)
73{
74 for (int i = 0; i < MENU_MAX; i++)
75 search_buffers[i] = NULL;
76}
77
83{
84 struct MuttWindow *win = window_get_focus();
85
86 // This should only happen before the first window is created
87 if (!win)
88 return MENU_INDEX;
89
90 if ((win->type == WT_CUSTOM) && (win->parent->type == WT_PAGER))
91 return MENU_PAGER;
92
93 if (win->type != WT_MENU)
94 return MENU_GENERIC;
95
96 struct Menu *menu = win->wdata;
97 if (!menu)
98 return MENU_GENERIC;
99
100 return menu->md->id;
101}
102
107void menu_free(struct Menu **ptr)
108{
109 if (!ptr || !*ptr)
110 return;
111
112 struct Menu *menu = *ptr;
113
114 notify_free(&menu->notify);
115
116 if (menu->mdata_free && menu->mdata)
117 menu->mdata_free(menu, &menu->mdata); // Custom function to free private data
118
119 FREE(ptr);
120}
121
129struct Menu *menu_new(const struct MenuDefinition *md, struct MuttWindow *win,
130 struct ConfigSubset *sub)
131{
132 struct Menu *menu = MUTT_MEM_CALLOC(1, struct Menu);
133
134 menu->md = md;
135 menu->redraw = MENU_REDRAW_FULL;
136 menu->color = default_color;
137 menu->search = generic_search;
138 menu->notify = notify_new();
139 menu->win = win;
140 menu->page_len = win->state.rows;
141 menu->sub = sub;
142 menu->show_indicator = true;
143
145 menu_add_observers(menu);
146
147 return menu;
148}
149
155int menu_get_index(struct Menu *menu)
156{
157 if (!menu)
158 return -1;
159
160 return menu->current;
161}
162
169MenuRedrawFlags menu_set_index(struct Menu *menu, int index)
170{
171 return menu_move_selection(menu, index);
172}
173
180{
181 if (!menu)
182 return;
183
184 menu->redraw |= redraw;
185 menu->win->actions |= WA_RECALC;
186}
Color and attribute parsing.
struct AttrColor * simple_color_get(enum ColorId cid)
Get the colour of an object by its ID.
Definition simple.c:98
@ MT_COLOR_NORMAL
Plain text.
Definition color.h:53
Convenience wrapper for the core headers.
Parse Expando string.
static const struct AttrColor * default_color(struct Menu *menu, int line)
Get the default colour for a line of the menu - Implements Menu::color() -.
Definition menu.c:49
static int generic_search(struct Menu *menu, regex_t *rx, int line)
Search a menu for a item matching a regex - Implements Menu::search() -.
Definition menu.c:57
Convenience wrapper for the gui headers.
Manage keymappings.
#define FREE(x)
Free memory and set the pointer to NULL.
Definition memory.h:68
#define MUTT_MEM_CALLOC(n, type)
Definition memory.h:52
GUI present the user with a selectable list.
#define MENU_REDRAW_FULL
Redraw everything.
Definition lib.h:60
uint8_t MenuRedrawFlags
Flags, e.g. MENU_REDRAW_INDEX.
Definition lib.h:55
MenuRedrawFlags menu_move_selection(struct Menu *menu, int index)
Move the selection, keeping within between [0, menu->max].
Definition move.c:236
enum MenuType menu_get_current_type(void)
Get the type of the current Window.
Definition menu.c:82
void menu_init2(char **search_buffers)
Initialise all the Menus.
Definition menu.c:72
void menu_queue_redraw(struct Menu *menu, MenuRedrawFlags redraw)
Queue a request for a redraw.
Definition menu.c:179
int menu_get_index(struct Menu *menu)
Get the current selection in the Menu.
Definition menu.c:155
struct Menu * menu_new(const struct MenuDefinition *md, struct MuttWindow *win, struct ConfigSubset *sub)
Create a new Menu.
Definition menu.c:129
void menu_free(struct Menu **ptr)
Free a Menu.
Definition menu.c:107
MenuRedrawFlags menu_set_index(struct Menu *menu, int index)
Set the current selection in the Menu.
Definition menu.c:169
Menu private Module data.
void menu_add_observers(struct Menu *menu)
Add the notification observers.
Definition observer.c:134
Private Menu functions.
Convenience wrapper for the library headers.
struct Notify * notify_new(void)
Create a new notifications handler.
Definition notify.c:62
void notify_set_parent(struct Notify *notify, struct Notify *parent)
Set the parent notification handler.
Definition notify.c:95
void notify_free(struct Notify **ptr)
Free a notification handler.
Definition notify.c:75
struct MuttWindow * window_get_focus(void)
Get the currently focused Window.
#define WA_RECALC
Recalculate the contents of the Window.
@ WT_CUSTOM
Window with a custom drawing function.
Definition mutt_window.h:94
@ WT_PAGER
A panel containing the Pager Window.
Definition mutt_window.h:99
@ WT_MENU
An Window containing a Menu.
Definition mutt_window.h:97
struct Buffer * buf_pool_get(void)
Get a Buffer from the pool.
Definition pool.c:91
void buf_pool_release(struct Buffer **ptr)
Return a Buffer to the pool.
Definition pool.c:111
A curses colour and its attributes.
Definition attr.h:65
String manipulation buffer.
Definition buffer.h:36
char * data
Pointer to data.
Definition buffer.h:37
A set of inherited config items.
Definition subset.h:46
Functions for a Dialog or Window.
Definition menu.h:77
int id
Menu ID, e.g. MENU_ALIAS.
Definition menu.h:78
Definition lib.h:80
struct MuttWindow * win
Window holding the Menu.
Definition lib.h:88
int current
Current entry.
Definition lib.h:81
const struct AttrColor *(* color)(struct Menu *menu, int line)
Definition lib.h:145
MenuRedrawFlags redraw
When to redraw the screen.
Definition lib.h:83
void(* mdata_free)(struct Menu *menu, void **ptr)
Definition lib.h:163
bool show_indicator
Show the Indicator colour.
Definition lib.h:87
int(* search)(struct Menu *menu, regex_t *rx, int line)
Definition lib.h:121
const struct MenuDefinition * md
Menu definition for keymap entries.
Definition lib.h:84
int(* make_entry)(struct Menu *menu, int line, int max_cols, struct Buffer *buf)
Definition lib.h:108
struct ConfigSubset * sub
Inherited config items.
Definition lib.h:89
struct Notify * notify
Notifications.
Definition lib.h:147
void * mdata
Private data.
Definition lib.h:149
int page_len
Number of entries per screen.
Definition lib.h:85
struct WindowState state
Current state of the Window.
void * wdata
Private data.
struct Notify * notify
Notifications: NotifyWindow, EventWindow.
struct MuttWindow * parent
Parent Window.
WindowActionFlags actions
Actions to be performed, e.g. WA_RECALC.
enum WindowType type
Window type, e.g. WT_SIDEBAR.
short rows
Number of rows, can be MUTT_WIN_SIZE_UNLIMITED.
Definition mutt_window.h:61
Menu types.
MenuType
Types of GUI selections.
Definition type.h:33
@ MENU_INDEX
Index panel (list of emails)
Definition type.h:44
@ MENU_GENERIC
Generic selection list.
Definition type.h:43
@ MENU_PAGER
Pager pager (email viewer)
Definition type.h:45
@ MENU_MAX
Definition type.h:51