functions_sidebar.c File Reference

Sidebar functions. More...

#include "config.h"
#include <stdbool.h>
#include <string.h>
#include "private.h"
#include "mutt/lib.h"
#include "config/lib.h"
#include "core/lib.h"
#include "gui/lib.h"
#include "functions_sidebar.h"
#include "lib.h"
#include "editor/lib.h"
#include "index/lib.h"
#include "key/lib.h"
#include "menu/lib.h"
#include "functions_fuzzy.h"
#include "module_data.h"

Include dependency graph for functions_sidebar.c:

Go to the source code of this file.

Functions
void	sidebar_init_keys (struct NeoMutt *n, struct SubMenu *sm_generic)
	Initialise the Sidebar Keybindings - Implements ::init_keys_api.
struct SubMenu *	sidebar_get_submenu (void)
	Get the Sidebar SubMenu.
bool	sb_next (struct SidebarWindowData *wdata)
	Find the next unhidden Mailbox.
static bool	sb_next_n (struct SidebarWindowData *wdata, int count)
	Move down N unhidden Mailboxes, capping at the last.
static bool	sb_prev_n (struct SidebarWindowData *wdata, int count)
	Move up N unhidden Mailboxes, capping at the first.
static struct SbEntry **	sb_next_new (struct SidebarWindowData *wdata, size_t begin, size_t end)
	Return the next mailbox with new messages.
bool	sb_prev (struct SidebarWindowData *wdata)
	Find the previous unhidden Mailbox.
static struct SbEntry **	sb_prev_new (struct SidebarWindowData *wdata, size_t begin, size_t end)
	Return the previous mailbox with new messages.
int	op_sidebar_first (struct SidebarFunctionData *fdata, const struct KeyEvent *event)
	Selects the first unhidden mailbox - Implements sidebar_function_t -.
int	op_sidebar_last (struct SidebarFunctionData *fdata, const struct KeyEvent *event)
	Selects the last unhidden mailbox - Implements sidebar_function_t -.
int	op_sidebar_next (struct SidebarFunctionData *fdata, const struct KeyEvent *event)
	Selects the next unhidden mailbox - Implements sidebar_function_t -.
static int	op_sidebar_next_new (struct SidebarFunctionData *fdata, const struct KeyEvent *event)
	Selects the next new mailbox - Implements sidebar_function_t -.
int	op_sidebar_open (struct SidebarFunctionData *fdata, const struct KeyEvent *event)
	Open highlighted mailbox - Implements sidebar_function_t -.
int	op_sidebar_page_down (struct SidebarFunctionData *fdata, const struct KeyEvent *event)
	Selects the first entry in the next page of mailboxes - Implements sidebar_function_t -.
int	op_sidebar_page_up (struct SidebarFunctionData *fdata, const struct KeyEvent *event)
	Selects the last entry in the previous page of mailboxes - Implements sidebar_function_t -.
int	op_sidebar_prev (struct SidebarFunctionData *fdata, const struct KeyEvent *event)
	Selects the previous unhidden mailbox - Implements sidebar_function_t -.
static int	op_sidebar_prev_new (struct SidebarFunctionData *fdata, const struct KeyEvent *event)
	Selects the previous new mailbox - Implements sidebar_function_t -.
static int	op_sidebar_toggle_visible (struct SidebarFunctionData *fdata, const struct KeyEvent *event)
	Make the sidebar (in)visible - Implements sidebar_function_t -.
static int	op_sidebar_toggle_virtual (struct SidebarFunctionData *fdata, const struct KeyEvent *event)
	Deprecated - Implements sidebar_function_t -.
int	sb_function_dispatcher (struct MuttWindow *win, const struct KeyEvent *event)
	Perform a Sidebar function - Implements function_dispatcher_t -.

Variables
static const struct MenuFuncOp	OpSidebar []
	Functions for the Sidebar Window.
const struct MenuOpSeq	SidebarDefaultBindings []
	Key bindings for the Sidebar Window.
static const struct SidebarFunction	SidebarFunctions []
	All the NeoMutt functions that the Sidebar supports.

Detailed Description

Sidebar functions.

Authors

• Pietro Cerutti
• 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 functions_sidebar.c.

Function Documentation

sidebar_init_keys()

void sidebar_init_keys	(	struct NeoMutt *	n,
		struct SubMenu *	sm_generic )

Initialise the Sidebar Keybindings - Implements ::init_keys_api.

Definition at line 78 of file functions_sidebar.c.

{
  struct SidebarModuleData *mod_data = neomutt_get_module_data(n, MODULE_ID_SIDEBAR);
  ASSERT(mod_data);
 
  struct MenuDefinition *md = NULL;
  struct SubMenu *sm = NULL;
  struct SubMenu *sm_editor = editor_get_submenu();
  ASSERT(sm_editor);
 
  sm = km_register_submenu(OpSidebar);
  md = km_register_menu(MENU_SIDEBAR, "sidebar");
  km_menu_add_submenu(md, sm);
  km_menu_add_submenu(md, sm_editor);
  km_menu_add_bindings(md, SidebarDefaultBindings);
 
  mod_data->md_sidebar = md;
  mod_data->sm_sidebar = sm;
}

Here is the call graph for this function:

Here is the caller graph for this function:

sidebar_get_submenu()

struct SubMenu * sidebar_get_submenu

(

void

)

Get the Sidebar SubMenu.

Return values

ptr	Sidebar SubMenu

Definition at line 102 of file functions_sidebar.c.

{
  struct SidebarModuleData *mod_data = neomutt_get_module_data(NeoMutt, MODULE_ID_SIDEBAR);
  ASSERT(mod_data);
 
  return mod_data->sm_sidebar;
}

Here is the call graph for this function:

Here is the caller graph for this function:

sb_next()

bool sb_next

(

struct SidebarWindowData *

wdata

)

Find the next unhidden Mailbox.

Parameters

wdata

Sidebar data

Return values

true	Mailbox found

Definition at line 115 of file functions_sidebar.c.

{
  struct SbEntry **sbep = NULL;
  ARRAY_FOREACH_FROM(sbep, &wdata->entries, wdata->hil_index + 1)
  {
    if (!(*sbep)->is_hidden)
    {
      wdata->hil_index = ARRAY_FOREACH_IDX_sbep;
      return true;
    }
  }
 
  return false;
}

Here is the caller graph for this function:

sb_next_n()

static bool sb_next_n ( struct SidebarWindowData * wdata, int count )

static

Move down N unhidden Mailboxes, capping at the last.

Parameters

wdata	Sidebar data
count	Number of entries to move

Return values

true	Moved at least one entry
false	Already at the last unhidden entry

Definition at line 137 of file functions_sidebar.c.

{
  int orig = wdata->hil_index;
  for (int i = 0; i < count; i++)
  {
    if (!sb_next(wdata))
      break;
  }
  return (wdata->hil_index != orig);
}

Here is the call graph for this function:

Here is the caller graph for this function:

sb_prev_n()

static bool sb_prev_n ( struct SidebarWindowData * wdata, int count )

static

Move up N unhidden Mailboxes, capping at the first.

Parameters

wdata	Sidebar data
count	Number of entries to move

Return values

true	Moved at least one entry
false	Already at the first unhidden entry

Definition at line 155 of file functions_sidebar.c.

{
  int orig = wdata->hil_index;
  for (int i = 0; i < count; i++)
  {
    if (!sb_prev(wdata))
      break;
  }
  return (wdata->hil_index != orig);
}

Here is the call graph for this function:

Here is the caller graph for this function:

sb_next_new()

static struct SbEntry ** sb_next_new ( struct SidebarWindowData * wdata, size_t begin, size_t end )

static

Return the next mailbox with new messages.

Parameters

wdata	Sidebar data
begin	Starting index for searching
end	Ending index for searching

Return values

ptr	Pointer to the first entry with new messages
NULL	None could be found

Definition at line 174 of file functions_sidebar.c.

{
  struct SbEntry **sbep = NULL;
  ARRAY_FOREACH_FROM_TO(sbep, &wdata->entries, begin, end)
  {
    if ((*sbep)->mailbox->has_new || ((*sbep)->mailbox->msg_unread != 0))
      return sbep;
  }
  return NULL;
}

Here is the caller graph for this function:

sb_prev()

bool sb_prev

(

struct SidebarWindowData *

wdata

)

Find the previous unhidden Mailbox.

Parameters

wdata

Sidebar data

Return values

true	Mailbox found

Definition at line 190 of file functions_sidebar.c.

{
  struct SbEntry **sbep = NULL, **prev = NULL;
  ARRAY_FOREACH_TO(sbep, &wdata->entries, wdata->hil_index)
  {
    if (!(*sbep)->is_hidden)
      prev = sbep;
  }
 
  if (prev)
  {
    wdata->hil_index = ARRAY_IDX(&wdata->entries, prev);
    return true;
  }
 
  return false;
}

Here is the caller graph for this function:

sb_prev_new()

static struct SbEntry ** sb_prev_new ( struct SidebarWindowData * wdata, size_t begin, size_t end )

static

Return the previous mailbox with new messages.

Parameters

wdata	Sidebar data
begin	Starting index for searching
end	Ending index for searching

Return values

ptr	Pointer to the first entry with new messages
NULL	None could be found

Definition at line 216 of file functions_sidebar.c.

{
  struct SbEntry **sbep = NULL, **prev = NULL;
  ARRAY_FOREACH_FROM_TO(sbep, &wdata->entries, begin, end)
  {
    if ((*sbep)->mailbox->has_new || ((*sbep)->mailbox->msg_unread != 0))
      prev = sbep;
  }
 
  return prev;
}

Here is the caller graph for this function:

Variable Documentation

OpSidebar

const struct MenuFuncOp OpSidebar[]

static

Initial value:

= { 
  { "sidebar-first",          OP_SIDEBAR_FIRST          },
  { "sidebar-last",           OP_SIDEBAR_LAST           },
  { "sidebar-next",           OP_SIDEBAR_NEXT           },
  { "sidebar-next-new",       OP_SIDEBAR_NEXT_NEW       },
  { "sidebar-open",           OP_SIDEBAR_OPEN           },
  { "sidebar-page-down",      OP_SIDEBAR_PAGE_DOWN      },
  { "sidebar-page-up",        OP_SIDEBAR_PAGE_UP        },
  { "sidebar-prev",           OP_SIDEBAR_PREV           },
  { "sidebar-prev-new",       OP_SIDEBAR_PREV_NEW       },
  { "sidebar-start-search",   OP_SIDEBAR_START_SEARCH   },
  { "sidebar-toggle-virtual", OP_SIDEBAR_TOGGLE_VIRTUAL },
  { "sidebar-toggle-visible", OP_SIDEBAR_TOGGLE_VISIBLE },
  { NULL, 0 },
}

Functions for the Sidebar Window.

Definition at line 51 of file functions_sidebar.c.

                                             { /* map: sidebar */
  { "sidebar-first",          OP_SIDEBAR_FIRST          },
  { "sidebar-last",           OP_SIDEBAR_LAST           },
  { "sidebar-next",           OP_SIDEBAR_NEXT           },
  { "sidebar-next-new",       OP_SIDEBAR_NEXT_NEW       },
  { "sidebar-open",           OP_SIDEBAR_OPEN           },
  { "sidebar-page-down",      OP_SIDEBAR_PAGE_DOWN      },
  { "sidebar-page-up",        OP_SIDEBAR_PAGE_UP        },
  { "sidebar-prev",           OP_SIDEBAR_PREV           },
  { "sidebar-prev-new",       OP_SIDEBAR_PREV_NEW       },
  { "sidebar-start-search",   OP_SIDEBAR_START_SEARCH   },
  { "sidebar-toggle-virtual", OP_SIDEBAR_TOGGLE_VIRTUAL },
  { "sidebar-toggle-visible", OP_SIDEBAR_TOGGLE_VISIBLE },
  { NULL, 0 },
};

SidebarDefaultBindings

const struct MenuOpSeq SidebarDefaultBindings[]

Initial value:

= { 
  { 0, NULL },
}

Key bindings for the Sidebar Window.

Definition at line 70 of file functions_sidebar.c.

                                                  { /* map: sidebar */
  { 0, NULL },
};

SidebarFunctions

const struct SidebarFunction SidebarFunctions[]

static

Initial value:

= {
  
  { OP_SIDEBAR_FIRST,          op_sidebar_first },
  { OP_SIDEBAR_LAST,           op_sidebar_last },
  { OP_SIDEBAR_NEXT,           op_sidebar_next },
  { OP_SIDEBAR_NEXT_NEW,       op_sidebar_next_new },
  { OP_SIDEBAR_OPEN,           op_sidebar_open },
  { OP_SIDEBAR_PAGE_DOWN,      op_sidebar_page_down },
  { OP_SIDEBAR_PAGE_UP,        op_sidebar_page_up },
  { OP_SIDEBAR_PREV,           op_sidebar_prev },
  { OP_SIDEBAR_PREV_NEW,       op_sidebar_prev_new },
  { OP_SIDEBAR_START_SEARCH,   op_sidebar_start_search },
  { OP_SIDEBAR_TOGGLE_VIRTUAL, op_sidebar_toggle_virtual },
  { OP_SIDEBAR_TOGGLE_VISIBLE, op_sidebar_toggle_visible },
  { 0, NULL },
  
}

All the NeoMutt functions that the Sidebar supports.

Definition at line 526 of file functions_sidebar.c.

                                                         {
  // clang-format off
  { OP_SIDEBAR_FIRST,          op_sidebar_first },
  { OP_SIDEBAR_LAST,           op_sidebar_last },
  { OP_SIDEBAR_NEXT,           op_sidebar_next },
  { OP_SIDEBAR_NEXT_NEW,       op_sidebar_next_new },
  { OP_SIDEBAR_OPEN,           op_sidebar_open },
  { OP_SIDEBAR_PAGE_DOWN,      op_sidebar_page_down },
  { OP_SIDEBAR_PAGE_UP,        op_sidebar_page_up },
  { OP_SIDEBAR_PREV,           op_sidebar_prev },
  { OP_SIDEBAR_PREV_NEW,       op_sidebar_prev_new },
  { OP_SIDEBAR_START_SEARCH,   op_sidebar_start_search },
  { OP_SIDEBAR_TOGGLE_VIRTUAL, op_sidebar_toggle_virtual },
  { OP_SIDEBAR_TOGGLE_VISIBLE, op_sidebar_toggle_visible },
  { 0, NULL },
  // clang-format on
};