NeoMutt  2022-04-29-145-g9b6a0e
Teaching an old dog new tricks
dialog.c File Reference

Dialog Windows. More...

#include "config.h"
#include <stddef.h>
#include <stdbool.h>
#include "mutt/lib.h"
#include "lib.h"
+ Include dependency graph for dialog.c:

Go to the source code of this file.


struct MuttWindowdialog_find (struct MuttWindow *win)
 Find the parent Dialog of a Window. More...
void dialog_push (struct MuttWindow *dlg)
 Display a Window to the user. More...
void dialog_pop (void)
 Hide a Window from the user. More...
static int alldialogs_window_observer (struct NotifyCallback *nc)
 Notification that a Window has changed - Implements observer_t -. More...
struct MuttWindowalldialogs_new (void)
 Create the AllDialogs Window. More...
struct MuttWindowalldialogs_get_current (void)
 Get the currently active Dialog. More...


struct MuttWindowAllDialogsWindow = NULL
 Parent of all Dialogs. More...

Detailed Description

Dialog Windows.

  • Richard Russon

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see

Definition in file dialog.c.

Function Documentation

◆ dialog_find()

struct MuttWindow* dialog_find ( struct MuttWindow win)

Find the parent Dialog of a Window.

Return values

Dialog Windows will be owned by a MuttWindow of type WT_ALL_DIALOGS.

Definition at line 83 of file dialog.c.

84 {
85  for (; win && win->parent; win = win->parent)
86  {
87  if (win->parent->type == WT_ALL_DIALOGS)
88  return win;
89  }
91  return NULL;
92 }
Container for All Dialogs (nested Windows)
Definition: mutt_window.h:74
struct MuttWindow * parent
Parent Window.
Definition: mutt_window.h:135
enum WindowType type
Window type, e.g. WT_SIDEBAR.
Definition: mutt_window.h:144
+ Here is the caller graph for this function:

◆ dialog_push()

void dialog_push ( struct MuttWindow dlg)

Display a Window to the user.

dlgWindow to display

The Dialog Windows are kept in a stack. The topmost is visible to the user, whilst the others are hidden.

When a Window is pushed, the old Window is marked as not visible.

Definition at line 103 of file dialog.c.

104 {
105  if (!dlg || !AllDialogsWindow)
106  return;
108  struct MuttWindow *last = TAILQ_LAST(&AllDialogsWindow->children, MuttWindowList);
109  if (last)
110  last->state.visible = false;
115  // Notify the world, allowing plugins to integrate
116  mutt_debug(LL_NOTIFY, "NT_WINDOW_DIALOG visible: %s, %p\n",
117  mutt_window_win_name(dlg), dlg);
118  struct EventWindow ev_w = { dlg, WN_VISIBLE };
121  dlg->state.visible = true;
122  dlg->parent = AllDialogsWindow;
124  window_set_focus(dlg);
127  debug_win_dump();
128 #endif
129 }
void debug_win_dump(void)
Definition: window.c:95
struct MuttWindow * AllDialogsWindow
Parent of all Dialogs.
Definition: dialog.c:74
#define mutt_debug(LEVEL,...)
Definition: logging.h:84
Log of notifications.
Definition: logging.h:45
bool notify_send(struct Notify *notify, enum NotifyType event_type, int event_subtype, void *event_data)
Send out a notification message.
Definition: notify.c:171
void notify_set_parent(struct Notify *notify, struct Notify *parent)
Set the parent notification handler.
Definition: notify.c:93
void mutt_window_reflow(struct MuttWindow *win)
Resize a Window and its children.
Definition: mutt_window.c:340
const char * mutt_window_win_name(const struct MuttWindow *win)
Get the name of a Window.
Definition: mutt_window.c:710
struct MuttWindow * window_set_focus(struct MuttWindow *win)
Set the Window focus.
Definition: mutt_window.c:659
A new Dialog Window has been created, e.g. WT_DLG_INDEX.
Definition: mutt_window.h:208
#define WN_VISIBLE
Window became visible.
Definition: mutt_window.h:192
MuttWindow has changed, NotifyWindow, EventWindow.
Definition: notify_type.h:55
#define TAILQ_INSERT_TAIL(head, elm, field)
Definition: queue.h:809
#define TAILQ_LAST(head, headname)
Definition: queue.h:819
An Event that happened to a Window.
Definition: mutt_window.h:216
struct WindowState state
Current state of the Window.
Definition: mutt_window.h:127
struct Notify * notify
Notifications: NotifyWindow, EventWindow.
Definition: mutt_window.h:138
struct MuttWindowList children
Children Windows.
Definition: mutt_window.h:136
bool visible
Window is visible.
Definition: mutt_window.h:59
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ dialog_pop()

void dialog_pop ( void  )

Hide a Window from the user.

The topmost (visible) Window is removed from the stack and the next Window is marked as visible.

Definition at line 137 of file dialog.c.

138 {
139  if (!AllDialogsWindow)
140  return;
142  struct MuttWindow *last = TAILQ_LAST(&AllDialogsWindow->children, MuttWindowList);
143  if (!last)
144  return;
146  // Notify the world, allowing plugins to clean up
147  mutt_debug(LL_NOTIFY, "NT_WINDOW_DIALOG hidden: %s, %p\n",
148  mutt_window_win_name(last), last);
149  struct EventWindow ev_w = { last, WN_HIDDEN };
152  last->state.visible = false;
153  last->parent = NULL;
154  TAILQ_REMOVE(&AllDialogsWindow->children, last, entries);
156  last = TAILQ_LAST(&AllDialogsWindow->children, MuttWindowList);
157  if (last)
158  {
159  last->state.visible = true;
161  window_set_focus(last);
162  }
163  else
164  {
165  AllDialogsWindow->focus = NULL;
166  }
168  debug_win_dump();
169 #endif
170 }
#define WN_HIDDEN
Window became hidden.
Definition: mutt_window.h:193
#define TAILQ_REMOVE(head, elm, field)
Definition: queue.h:841
struct MuttWindow * focus
Focused Window.
Definition: mutt_window.h:140
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ alldialogs_new()

struct MuttWindow* alldialogs_new ( void  )

Create the AllDialogs Window.

Return values
ptrNew AllDialogs Window

Create the container for all the Dialogs.

Definition at line 205 of file dialog.c.

206 {
211  notify_observer_add(win_alldlgs->notify, NT_WINDOW, alldialogs_window_observer, win_alldlgs);
213  AllDialogsWindow = win_alldlgs;
215  return win_alldlgs;
216 }
static int alldialogs_window_observer(struct NotifyCallback *nc)
Notification that a Window has changed - Implements observer_t -.
Definition: dialog.c:179
bool notify_observer_add(struct Notify *notify, enum NotifyType type, observer_t callback, void *global_data)
Add an observer to an object.
Definition: notify.c:189
struct MuttWindow * mutt_window_new(enum WindowType type, enum MuttWindowOrientation orient, enum MuttWindowSize size, int cols, int rows)
Create a new Window.
Definition: mutt_window.c:181
Window uses all available vertical space.
Definition: mutt_window.h:38
Use as much space as possible.
Definition: mutt_window.h:52
Window wants as much space as possible.
Definition: mutt_window.h:48
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ alldialogs_get_current()

struct MuttWindow* alldialogs_get_current ( void  )

Get the currently active Dialog.

Return values
ptrActive Dialog

Definition at line 222 of file dialog.c.

223 {
224  if (!AllDialogsWindow)
225  return NULL;
227  struct MuttWindow *np = NULL;
228  TAILQ_FOREACH(np, &AllDialogsWindow->children, entries)
229  {
230  if (mutt_window_is_visible(np))
231  return np;
232  }
234  return NULL;
235 }
bool mutt_window_is_visible(struct MuttWindow *win)
Is the Window visible?
Definition: mutt_window.c:501
#define TAILQ_FOREACH(var, head, field)
Definition: queue.h:725
+ Here is the call graph for this function:

Variable Documentation

◆ AllDialogsWindow

struct MuttWindow* AllDialogsWindow = NULL

Parent of all Dialogs.

Definition at line 74 of file dialog.c.