ROX-Filer/src/filer.h

   1 /*
   2  * ROX-Filer, filer for the ROX desktop project
   3  * By Thomas Leonard, <tal197@users.sourceforge.net>.
   4  */
   5
   6 #ifndef _FILER_H
   7 #define _FILER_H
   8
   9 #include <gtk/gtk.h>
  10
  11 enum {
  12         RESIZE_STYLE = 0,
  13         RESIZE_ALWAYS = 1,
  14         RESIZE_NEVER = 2,
  15 };
  16
  17 typedef enum
  18 {
  19         OPEN_SHIFT              = 0x01, /* Do ShiftOpen */
  20         OPEN_SAME_WINDOW        = 0x02, /* Directories open in same window */
  21         OPEN_CLOSE_WINDOW       = 0x04, /* Opening files closes the window */
  22         OPEN_FROM_MINI          = 0x08, /* Non-dir => close minibuffer */
  23 } OpenFlags;
  24
  25 typedef enum
  26 {
  27         FILER_NEEDS_RESCAN      = 0x01, /* Call may_rescan after scanning */
  28         FILER_UPDATING          = 0x02, /* (scanning) items may already exist */
  29         FILER_CREATE_THUMBS     = 0x04, /* Create thumbs when scan ends */
  30 } FilerFlags;
  31
  32 /* Numbers used in options */
  33 typedef enum
  34 {
  35         VIEW_TYPE_COLLECTION = 0,       /* Icons view */
  36         VIEW_TYPE_DETAILS = 1           /* TreeView details list */
  37 } ViewType;
  38
  39 /* Filter types */
  40 typedef enum
  41 {
  42         FILER_SHOW_ALL,           /* Show all files, modified by show_hidden */
  43         FILER_SHOW_GLOB,          /* Show files that match a glob pattern */
  44 } FilterType;
  45
  46 /* iter's next method has just returned the clicked item... */
  47 typedef void (*TargetFunc)(FilerWindow *filer_window,
  48                            ViewIter *iter,
  49                            gpointer data);
  50
  51 struct _FilerWindow
  52 {
  53         GtkWidget       *window;
  54         GtkBox          *toplevel_vbox, *view_hbox;
  55         gboolean        scanning;       /* State of the 'scanning' indicator */
  56         gchar           *sym_path;              /* Path the user sees */
  57         gchar           *real_path;             /* realpath(sym_path) */
  58         ViewIface       *view;
  59         ViewType        view_type;
  60         gboolean        temp_item_selected;
  61         gboolean        show_hidden;
  62         FilerFlags      flags;
  63         SortType        sort_type;
  64         GtkSortType     sort_order;
  65
  66         DetailsType     details_type;
  67         DisplayStyle    display_style;
  68         DisplayStyle    display_style_wanted;
  69
  70         Directory       *directory;
  71
  72         gboolean        had_cursor;     /* (before changing directory) */
  73         char            *auto_select;   /* If it we find while scanning */
  74
  75         GtkWidget       *message;       /* The 'Running as ...' message */
  76
  77         GtkWidget       *minibuffer_area;       /* The hbox to show/hide */
  78         GtkWidget       *minibuffer_label;      /* The operation name */
  79         GtkWidget       *minibuffer;            /* The text entry */
  80         int             mini_cursor_base;       /* XXX */
  81         MiniType        mini_type;
  82
  83         FilterType      filter;
  84         gchar           *filter_string;  /* Glob or regexp pattern */
  85         gchar           *regexp;         /* Compiled regexp pattern */
  86         /* TRUE if hidden files are shown because the minibuffer leafname
  87          * starts with a dot.
  88          */
  89         gboolean        temp_show_hidden;
  90
  91         TargetFunc      target_cb;
  92         gpointer        target_data;
  93
  94         GtkWidget       *toolbar;
  95         GtkWidget       *toolbar_text;
  96         GtkWidget       *scrollbar;
  97
  98         gint            open_timeout;   /* Will resize and show window... */
  99
 100         GtkStateType    selection_state;        /* for drawing selection */
 101
 102         gboolean        show_thumbs;
 103         GList           *thumb_queue;           /* paths to thumbnail */
 104         GtkWidget       *thumb_bar, *thumb_progress;
 105         int             max_thumbs;             /* total for this batch */
 106
 107         gint            auto_scroll;            /* Timer */
 108
 109         char            *window_id;             /* For remote control */
 110 };
 111
 112 extern FilerWindow      *window_with_focus;
 113 extern GList            *all_filer_windows;
 114 extern GHashTable       *child_to_filer;
 115 extern Option           o_filer_auto_resize, o_unique_filer_windows;
 116 extern Option           o_filer_size_limit;
 117
 118 /* Prototypes */
 119 void filer_init(void);
 120 FilerWindow *filer_opendir(const char *path, FilerWindow *src_win, const gchar *wm_class);
 121 gboolean filer_update_dir(FilerWindow *filer_window, gboolean warning);
 122 void filer_update_all(void);
 123 DirItem *filer_selected_item(FilerWindow *filer_window);
 124 void change_to_parent(FilerWindow *filer_window);
 125 void full_refresh(void);
 126 void filer_openitem(FilerWindow *filer_window, ViewIter *iter, OpenFlags flags);
 127 void filer_check_mounted(const char *real_path);
 128 void filer_close_recursive(const char *path);
 129 void filer_change_to(FilerWindow *filer_window,
 130                         const char *path, const char *from);
 131 gboolean filer_exists(FilerWindow *filer_window);
 132 FilerWindow *filer_get_by_id(const char *id);
 133 void filer_set_id(FilerWindow *, const char *id);
 134 void filer_open_parent(FilerWindow *filer_window);
 135 void filer_detach_rescan(FilerWindow *filer_window);
 136 void filer_target_mode(FilerWindow      *filer_window,
 137                         TargetFunc      fn,
 138                         gpointer        data,
 139                         const char      *reason);
 140 GList *filer_selected_items(FilerWindow *filer_window);
 141 void filer_create_thumb(FilerWindow *filer_window, const gchar *pathname);
 142 void filer_cancel_thumbnails(FilerWindow *filer_window);
 143 void filer_set_title(FilerWindow *filer_window);
 144 void filer_create_thumbs(FilerWindow *filer_window);
 145 void filer_add_tip_details(FilerWindow *filer_window,
 146                            GString *tip, DirItem *item);
 147 void filer_selection_changed(FilerWindow *filer_window, gint time);
 148 void filer_lost_selection(FilerWindow *filer_window, guint time);
 149 void filer_window_set_size(FilerWindow *filer_window, int w, int h);
 150 gboolean filer_window_delete(GtkWidget *window,
 151                              GdkEvent *unused,
 152                              FilerWindow *filer_window);
 153 void filer_set_view_type(FilerWindow *filer_window, ViewType type);
 154 void filer_window_toggle_cursor_item_selected(FilerWindow *filer_window);
 155 void filer_perform_action(FilerWindow *filer_window, GdkEventButton *event);
 156 gint filer_motion_notify(FilerWindow *filer_window, GdkEventMotion *event);
 157 gint filer_key_press_event(GtkWidget *widget, GdkEventKey *event,
 158                            FilerWindow *filer_window);
 159 void filer_set_autoscroll(FilerWindow *filer_window, gboolean auto_scroll);
 160 void filer_refresh(FilerWindow *filer_window);
 161
 162 gboolean filer_match_filter(FilerWindow *filer_window, const gchar *filename);
 163 gboolean filer_set_filter(FilerWindow *filer_window,
 164                           FilterType type, const gchar *filter_string);
 165 void filer_set_hidden(FilerWindow *fwin, gboolean hidden);
 166 void filer_next_selected(FilerWindow *filer_window, int dir);
 167 void filer_save_settings(FilerWindow *fwin);
 168
 169 #endif /* _FILER_H */