sidebar.c File Reference

GUI display the mailboxes in a side panel. More...

#include "config.h"
#include <stdbool.h>
#include <stdio.h>
#include "private.h"
#include "mutt/lib.h"
#include "config/lib.h"
#include "core/lib.h"
#include "gui/lib.h"
#include "lib.h"
#include "index/lib.h"
#include "mutt_commands.h"

Include dependency graph for sidebar.c:

Go to the source code of this file.

Functions
struct Mailbox *	sb_get_highlight (struct MuttWindow *win)
	Get the Mailbox that's highlighted in the sidebar. More...
void	sb_add_mailbox (struct SidebarWindowData *wdata, struct Mailbox *m)
	Add a Mailbox to the Sidebar. More...
void	sb_remove_mailbox (struct SidebarWindowData *wdata, struct Mailbox *m)
	Remove a Mailbox from the Sidebar. More...
void	sb_set_current_mailbox (struct SidebarWindowData *wdata, struct Mailbox *m)
	Set the current Mailbox. More...
void	sb_init (void)
	Set up the Sidebar. More...
void	sb_shutdown (void)
	Clean up the Sidebar. More...

Variables
struct ListHead	SidebarWhitelist = STAILQ_HEAD_INITIALIZER(SidebarWhitelist)
	List of mailboxes to always display in the sidebar. More...
static const struct Command	sb_commands []

Detailed Description

GUI display the mailboxes in a side panel.

Authors

• Justin Hibbits
• Thomer M. Gil
• Richard Russon
• Kevin J. McCarthy

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 sidebar.c.

Function Documentation

sb_get_highlight()

struct Mailbox* sb_get_highlight

(

struct MuttWindow *

win

)

Get the Mailbox that's highlighted in the sidebar.

Parameters

win	Sidebar Window

Return values

ptr

Mailbox

Definition at line 58 of file sidebar.c.

{
  const bool c_sidebar_visible =
      cs_subset_bool(NeoMutt->sub, "sidebar_visible");
  if (!c_sidebar_visible)
    return NULL;

  struct SidebarWindowData *wdata = sb_wdata_get(win);
  if (wdata->hil_index < 0)
    return NULL;

  struct SbEntry **sbep = ARRAY_GET(&wdata->entries, wdata->hil_index);
  if (!sbep)
    return NULL;

  return (*sbep)->mailbox;
}

Here is the call graph for this function:

Here is the caller graph for this function:

sb_add_mailbox()

void sb_add_mailbox	(	struct SidebarWindowData *	wdata,
		struct Mailbox *	m
	)

Add a Mailbox to the Sidebar.

Parameters

wdata	Sidebar data
m	Mailbox to add

The Sidebar will be re-sorted, and the indices updated, when sb_recalc() is called.

Definition at line 84 of file sidebar.c.

{
  if (!m)
    return;

  /* Any new/deleted mailboxes will cause a refresh.  As long as
   * they're valid, our pointers will be updated in prepare_sidebar() */

  struct IndexSharedData *shared = wdata->shared;
  struct SbEntry *entry = mutt_mem_calloc(1, sizeof(struct SbEntry));
  entry->mailbox = m;

  if (wdata->top_index < 0)
    wdata->top_index = ARRAY_SIZE(&wdata->entries);
  if (wdata->bot_index < 0)
    wdata->bot_index = ARRAY_SIZE(&wdata->entries);
  if ((wdata->opn_index < 0) && shared->mailbox &&
      mutt_str_equal(m->realpath, shared->mailbox->realpath))
  {
    wdata->opn_index = ARRAY_SIZE(&wdata->entries);
  }

  ARRAY_ADD(&wdata->entries, entry);
}

Here is the call graph for this function:

Here is the caller graph for this function:

sb_remove_mailbox()

void sb_remove_mailbox	(	struct SidebarWindowData *	wdata,
		struct Mailbox *	m
	)

Remove a Mailbox from the Sidebar.

Parameters

wdata	Sidebar data
m	Mailbox to remove

Definition at line 114 of file sidebar.c.

{
  struct SbEntry **sbep = NULL;
  ARRAY_FOREACH(sbep, &wdata->entries)
  {
    if (mutt_str_equal((*sbep)->mailbox->realpath, m->realpath))
    {
      struct SbEntry *sbe_remove = *sbep;
      ARRAY_REMOVE(&wdata->entries, sbep);
      FREE(&sbe_remove);

      if (wdata->opn_index == ARRAY_FOREACH_IDX)
      {
        // Open item was deleted
        wdata->opn_index = -1;
      }
      else if ((wdata->opn_index > 0) && (wdata->opn_index > ARRAY_FOREACH_IDX))
      {
        // Open item is still visible, so adjust the index
        wdata->opn_index--;
      }

      if (wdata->hil_index == ARRAY_FOREACH_IDX)
      {
        // If possible, keep the highlight where it is
        struct SbEntry **sbep_cur = ARRAY_GET(&wdata->entries, ARRAY_FOREACH_IDX);
        if (!sbep_cur)
        {
          // The last entry was deleted, so backtrack
          select_prev(wdata);
        }
        else if ((*sbep)->is_hidden)
        {
          // Find the next unhidden entry, or the previous
          if (!select_next(wdata))
            if (!select_prev(wdata))
              wdata->hil_index = -1;
        }
      }
      else if ((wdata->hil_index > 0) && (wdata->hil_index > ARRAY_FOREACH_IDX))
      {
        // Highlighted item is still visible, so adjust the index
        wdata->hil_index--;
      }
      break;
    }
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

sb_set_current_mailbox()

void sb_set_current_mailbox	(	struct SidebarWindowData *	wdata,
		struct Mailbox *	m
	)

Set the current Mailbox.

Parameters

wdata	Sidebar data
m	Mailbox

Definition at line 168 of file sidebar.c.

{
  wdata->opn_index = -1;

  struct SbEntry **sbep = NULL;
  ARRAY_FOREACH(sbep, &wdata->entries)
  {
    if (m)
    {
      if (mutt_str_equal((*sbep)->mailbox->realpath, m->realpath))
      {
        wdata->opn_index = ARRAY_FOREACH_IDX;
        wdata->hil_index = ARRAY_FOREACH_IDX;
        break;
      }
    }
    (*sbep)->is_hidden = ((*sbep)->mailbox->flags & MB_HIDDEN);
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

sb_init()

void sb_init

(

void

)

Set up the Sidebar.

Definition at line 191 of file sidebar.c.

{
  COMMANDS_REGISTER(sb_commands);

  // Listen for dialog creation events
  notify_observer_add(AllDialogsWindow->notify, NT_WINDOW,
                      sb_insertion_window_observer, NULL);
}

Here is the call graph for this function:

Here is the caller graph for this function:

sb_shutdown()

void sb_shutdown

(

void

)

Clean up the Sidebar.

Definition at line 203 of file sidebar.c.

{
  if (AllDialogsWindow)
    notify_observer_remove(AllDialogsWindow->notify, sb_insertion_window_observer, NULL);
  mutt_list_free(&SidebarWhitelist);
}

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

SidebarWhitelist

struct ListHead SidebarWhitelist = STAILQ_HEAD_INITIALIZER(SidebarWhitelist)

List of mailboxes to always display in the sidebar.

Definition at line 44 of file sidebar.c.

sb_commands

const struct Command sb_commands[]

static

Initial value:

= {
  
  { "sidebar_whitelist",   sb_parse_whitelist,     0 },
  { "unsidebar_whitelist", sb_parse_unwhitelist,   0 },
  
}

Definition at line 46 of file sidebar.c.