mutt_window.h

Go to the documentation of this file.

 
#ifndef MUTT_GUI_MUTT_WINDOW_H
#define MUTT_GUI_MUTT_WINDOW_H
 
#include "config.h"
#include <stdbool.h>
#include <stdint.h>
#include "mutt/lib.h"
 
struct ConfigSubset;
 
enum MuttWindowOrientation
{
  MUTT_WIN_ORIENT_VERTICAL = 1, 
  MUTT_WIN_ORIENT_HORIZONTAL,   
};
 
enum MuttWindowSize
{
  MUTT_WIN_SIZE_FIXED = 1, 
  MUTT_WIN_SIZE_MAXIMISE,  
  MUTT_WIN_SIZE_MINIMISE,  
};
 
#define MUTT_WIN_SIZE_UNLIMITED -1 
 
struct WindowState
{
  bool visible;     
  short cols;       
  short rows;       
  short col_offset; 
  short row_offset; 
};
 
enum WindowType
{
  // Structural Windows
  WT_ROOT,            
  WT_CONTAINER,       
  WT_ALL_DIALOGS,     
 
  // Dialogs (nested Windows) displayed to the user
  WT_DLG_ALIAS,       
  WT_DLG_ATTACHMENT,  
  WT_DLG_AUTOCRYPT,   
  WT_DLG_BROWSER,     
  WT_DLG_CERTIFICATE, 
  WT_DLG_COMPOSE,     
  WT_DLG_GPGME,       
  WT_DLG_PAGER,       
  WT_DLG_HISTORY,     
  WT_DLG_INDEX,       
  WT_DLG_PATTERN,     
  WT_DLG_PGP,         
  WT_DLG_POSTPONED,   
  WT_DLG_QUERY,       
  WT_DLG_SMIME,       
 
  // Common Windows
  WT_CUSTOM,          
  WT_HELP_BAR,        
  WT_INDEX,           
  WT_MENU,            
  WT_MESSAGE,         
  WT_PAGER,           
  WT_SIDEBAR,         
  WT_STATUS_BAR,      
};
 
TAILQ_HEAD(MuttWindowList, MuttWindow);
 
typedef uint8_t WindowActionFlags; 
#define WA_NO_FLAGS        0       
#define WA_REFLOW    (1 << 0)      
#define WA_RECALC    (1 << 1)      
#define WA_REPAINT   (1 << 2)      
 
struct MuttWindow
{
  short req_cols;                    
  short req_rows;                    
 
  struct WindowState state;          
  struct WindowState old;            
 
  enum MuttWindowOrientation orient; 
  enum MuttWindowSize size;          
  WindowActionFlags actions;         
 
  TAILQ_ENTRY(MuttWindow) entries;   
  struct MuttWindow *parent;         
  struct MuttWindowList children;    
 
  struct Notify *notify;             
 
  struct MuttWindow *focus;          
  int help_menu;                     
  const struct Mapping *help_data;   
 
  enum WindowType type;              
  void *wdata;                       
 
  void (*wdata_free)(struct MuttWindow *win, void **ptr);
 
  int (*recalc)(struct MuttWindow *win);
 
  int (*repaint)(struct MuttWindow *win);
 
  bool (*recursor)(struct MuttWindow *win);
};
 
typedef uint8_t WindowNotifyFlags; 
#define WN_NO_FLAGS        0       
#define WN_TALLER    (1 << 0)      
#define WN_SHORTER   (1 << 1)      
#define WN_WIDER     (1 << 2)      
#define WN_NARROWER  (1 << 3)      
#define WN_MOVED     (1 << 4)      
#define WN_VISIBLE   (1 << 5)      
#define WN_HIDDEN    (1 << 6)      
 
enum NotifyWindow
{
  NT_WINDOW_ADD = 1, 
  NT_WINDOW_DELETE,  
  NT_WINDOW_STATE,   
  NT_WINDOW_DIALOG,  
  NT_WINDOW_FOCUS,   
};
 
struct EventWindow
{
  struct MuttWindow *win;  
  WindowNotifyFlags flags; 
};
 
// Functions that deal with the Window
void               mutt_window_add_child          (struct MuttWindow *parent, struct MuttWindow *child);
void               mutt_window_free               (struct MuttWindow **ptr);
void               mutt_window_get_coords         (struct MuttWindow *win, int *col, int *row);
struct MuttWindow *mutt_window_new                (enum WindowType type, enum MuttWindowOrientation orient, enum MuttWindowSize size, int cols, int rows);
void               mutt_window_reflow             (struct MuttWindow *win);
struct MuttWindow *mutt_window_remove_child       (struct MuttWindow *parent, struct MuttWindow *child);
int                mutt_window_wrap_cols          (int width, short wrap);
 
// Functions for drawing on the Window
int  mutt_window_addch    (struct MuttWindow *win, int ch);
int  mutt_window_addnstr  (struct MuttWindow *win, const char *str, int num);
int  mutt_window_addstr   (struct MuttWindow *win, const char *str);
void mutt_window_clearline(struct MuttWindow *win, int row);
void mutt_window_clear    (struct MuttWindow *win);
void mutt_window_clrtoeol (struct MuttWindow *win);
int  mutt_window_move     (struct MuttWindow *win, int col, int row);
int  mutt_window_mvaddstr (struct MuttWindow *win, int col, int row, const char *str);
int  mutt_window_mvprintw (struct MuttWindow *win, int col, int row, const char *fmt, ...)
                            __attribute__((__format__(__printf__, 4, 5)));
int  mutt_window_printf   (struct MuttWindow *win, const char *format, ...)
                            __attribute__((__format__(__printf__, 2, 3)));
bool mutt_window_is_visible(struct MuttWindow *win);
 
void               mutt_winlist_free (struct MuttWindowList *head);
struct MuttWindow *window_find_child (struct MuttWindow *win, enum WindowType type);
struct MuttWindow *window_find_parent(struct MuttWindow *win, enum WindowType type);
void               window_notify_all (struct MuttWindow *win);
void               window_set_visible(struct MuttWindow *win, bool visible);
struct MuttWindow *window_set_focus  (struct MuttWindow *win);
struct MuttWindow *window_get_focus  (void);
bool               window_is_focused (const struct MuttWindow *win);
 
void window_redraw(struct MuttWindow *win);
void window_invalidate_all(void);
const char *mutt_window_win_name(const struct MuttWindow *win);
bool window_status_on_top(struct MuttWindow *panel, struct ConfigSubset *sub);
 
#endif /* MUTT_GUI_MUTT_WINDOW_H */