dialog.c File Reference

Dialog Windows. More...

#include "config.h"
#include <stdbool.h>
#include <stddef.h>
#include "mutt/lib.h"
#include "core/lib.h"
#include "dialog.h"
#include "module_data.h"
#include "mutt_window.h"

Include dependency graph for dialog.c:

Go to the source code of this file.

Functions
struct MuttWindow *	dialog_find (struct MuttWindow *win)
	Find the parent Dialog of a Window.
void	dialog_push (struct MuttWindow *dlg)
	Display a Window to the user.
void	dialog_pop (void)
	Hide a Window from the user.
static int	alldialogs_window_observer (struct NotifyCallback *nc)
	Notification that a Window has changed - Implements observer_t -.
struct MuttWindow *	alldialogs_new (void)
	Create the AllDialogs Window.

Detailed Description

Dialog Windows.

Authors

• Richard Russon

Copyright

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, either version 2 of the License, or (at your option) any later version.

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 http://www.gnu.org/licenses/.

Definition in file dialog.c.

Function Documentation

dialog_find()

struct MuttWindow * dialog_find

(

struct MuttWindow *

win

)

Find the parent Dialog of a Window.

Parameters

win

Window

Return values

ptr

Dialog

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

Definition at line 89 of file dialog.c.

{
  for (; win && win->parent; win = win->parent)
  {
    if (win->parent->type == WT_ALL_DIALOGS)
      return win;
  }
 
  return NULL;
}

Here is the caller graph for this function:

dialog_push()

void dialog_push

(

struct MuttWindow *

dlg

)

Display a Window to the user.

Parameters

dlg	Window 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 109 of file dialog.c.

{
  if (!dlg)
    return;
 
  struct GuiModuleData *mod_data = neomutt_get_module_data(NeoMutt, MODULE_ID_GUI);
  if (!mod_data || !mod_data->all_dialogs_window)
    return;
 
  struct MuttWindow *win_alldlgs = mod_data->all_dialogs_window;
 
  struct MuttWindow **wp_last = ARRAY_LAST(&win_alldlgs->children);
  if (wp_last)
    (*wp_last)->state.visible = false;
 
  ARRAY_ADD(&win_alldlgs->children, dlg);
  notify_set_parent(dlg->notify, win_alldlgs->notify);
 
  // Notify the world, allowing plugins to integrate
  mutt_debug(LL_NOTIFY, "NT_WINDOW_DIALOG visible: %s, %p\n",
             mutt_window_win_name(dlg), (void *) dlg);
  struct EventWindow ev_w = { dlg, WN_VISIBLE };
  notify_send(dlg->notify, NT_WINDOW, NT_WINDOW_DIALOG, &ev_w);
 
  dlg->state.visible = true;
  dlg->parent = win_alldlgs;
  mutt_window_reflow(win_alldlgs);
 
#ifdef USE_DEBUG_WINDOW
  debug_win_dump();
#endif
}

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 148 of file dialog.c.

{
  struct GuiModuleData *mod_data = neomutt_get_module_data(NeoMutt, MODULE_ID_GUI);
  if (!mod_data || !mod_data->all_dialogs_window)
    return;
 
  struct MuttWindow *win_alldlgs = mod_data->all_dialogs_window;
 
  struct MuttWindow **wp_last = ARRAY_LAST(&win_alldlgs->children);
  if (!wp_last)
    return;
 
  struct MuttWindow *win_last = *wp_last;
 
  // Notify the world, allowing plugins to clean up
  mutt_debug(LL_NOTIFY, "NT_WINDOW_DIALOG hidden: %s, %p\n",
             mutt_window_win_name(win_last), (void *) win_last);
  struct EventWindow ev_w = { win_last, WN_HIDDEN };
  notify_send(win_last->notify, NT_WINDOW, NT_WINDOW_DIALOG, &ev_w);
 
  win_last->state.visible = false;
  win_last->parent = NULL;
  ARRAY_REMOVE(&win_alldlgs->children, wp_last);
 
  wp_last = ARRAY_LAST(&win_alldlgs->children);
  if (wp_last)
  {
    (*wp_last)->state.visible = true;
    mutt_window_reflow(win_alldlgs);
  }
  else
  {
    win_alldlgs->focus = NULL;
  }
#ifdef USE_DEBUG_WINDOW
  debug_win_dump();
#endif
}

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

ptr	New AllDialogs Window

Create the container for all the Dialogs.

Definition at line 223 of file dialog.c.

{
  struct MuttWindow *win_alldlgs = mutt_window_new(WT_ALL_DIALOGS, MUTT_WIN_ORIENT_VERTICAL,
                                                   MUTT_WIN_SIZE_MAXIMISE, MUTT_WIN_SIZE_UNLIMITED,
                                                   MUTT_WIN_SIZE_UNLIMITED);
 
  notify_observer_add(win_alldlgs->notify, NT_WINDOW, alldialogs_window_observer, win_alldlgs);
 
  struct GuiModuleData *mod_data = neomutt_get_module_data(NeoMutt, MODULE_ID_GUI);
  if (mod_data)
    mod_data->all_dialogs_window = win_alldlgs;
 
  return win_alldlgs;
}

Here is the call graph for this function:

Here is the caller graph for this function: