dialog.h File Reference

Dialog Windows. More...

This graph shows which files directly or indirectly include this file:

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_pop (void)
	Hide a Window from the user.
void	dialog_push (struct MuttWindow *dlg)
	Display a Window to the user.
struct MuttWindow *	alldialogs_new (void)
	Create the AllDialogs Window.

Variables
struct MuttWindow *	AllDialogsWindow
	Parent of all Dialogs.

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.h.

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

{
  if (!AllDialogsWindow)
    return;
 
  struct MuttWindow **wp_last = ARRAY_LAST(&AllDialogsWindow->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(&AllDialogsWindow->children, wp_last);
 
  wp_last = ARRAY_LAST(&AllDialogsWindow->children);
  if (wp_last)
  {
    (*wp_last)->state.visible = true;
    mutt_window_reflow(AllDialogsWindow);
  }
  else
  {
    AllDialogsWindow->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:

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 || !AllDialogsWindow)
    return;
 
  struct MuttWindow **wp_last = ARRAY_LAST(&AllDialogsWindow->children);
  if (wp_last)
    (*wp_last)->state.visible = false;
 
  ARRAY_ADD(&AllDialogsWindow->children, dlg);
  notify_set_parent(dlg->notify, AllDialogsWindow->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 = AllDialogsWindow;
  mutt_window_reflow(AllDialogsWindow);
 
#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 212 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);
 
  AllDialogsWindow = win_alldlgs;
 
  return win_alldlgs;
}

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

AllDialogsWindow

struct MuttWindow* AllDialogsWindow

extern

Parent of all Dialogs.

Definition at line 80 of file dialog.c.