enlightenment/src/view.h

#ifndef E_VIEW_H
#define E_VIEW_H

#include "e.h"
/*#include "background.h"*/
#include "scrollbar.h"
#include "fs.h"
#include "iconbar.h"
#include "object.h"
#include "e_dir.h"
#include "e_file.h"
#include "view_layout.h"

#ifndef E_VIEW_TYPEDEF
#define E_VIEW_TYPEDEF
typedef struct _E_View E_View;
#endif

#ifndef E_ICON_TYPEDEF
#define E_ICON_TYPEDEF
typedef struct _E_Icon E_Icon;
#endif

#ifndef E_ICONBAR_TYPEDEF
#define E_ICONBAR_TYPEDEF
typedef struct _E_Iconbar E_Iconbar;
#endif

#ifndef E_VIEW_MODEL_TYPEDEF
#define E_VIEW_MODEL_TYPEDEF
typedef struct _E_Dir E_Dir;
#endif

#ifndef E_VIEW_LAYOUT_TYPEDEF
#define E_VIEW_LAYOUT_TYPEDEF
typedef struct _E_View_Layout E_View_Layout;
typedef struct _E_View_Layout_Element E_View_Layout_Element;
#endif

#ifndef E_SCROLLBAR_TYPEDEF
#define E_SCROLLBAR_TYPEDEF
typedef struct _E_Scrollbar E_Scrollbar;
#endif

typedef enum
{
   E_DND_NONE,
   E_DND_COPY,
   E_DND_MOVE,
   E_DND_LINK,
   E_DND_ASK,
   E_DND_DELETED,
   E_DND_COPIED,
   E_DND_ICONBAR_ADD
}
E_dnd_enum;

struct _E_View
{
   E_Object            o;

   char               *name;

   E_Dir              *dir;

   struct
   {
      Evas_Render_Method  render_method;
      int                 back_pixmap;
   }
   options;

   Evas                evas;
   struct
   {
      Window              base;
      Window              main;
   }
   win;
   Pixmap              pmap;
   struct
   {
      int                 w, h;
      int                 force;
   }
   size;
   struct
   {
      int                 x, y;
   }
   scroll;
   struct
   {
      int                 x, y;
   }
   location;

   struct
   {
      /* +-----------------+
       * |        Wt       |
       * |  +-----------+  |
       * |Wl|           |Wr|
       * |  |    [I] Is |  |
       * |  |    Ig     |  |
       * |  |   [txt]   |  |
       * |  |     Ib    |  |
       * |  +-----------+  |
       * |       Wb        |
       * +-----------------+
       */
      struct
      {
	 int                 l, r, t, b;
      }
      window;
      struct
      {
	 int                 s, g, b;
      }
      icon;
   }
   spacing;
   struct
   {
      int                 on;
      /* The number of selected icons. */
      int                 count;
      /* The number of icons we selected the last time.
       * If this is > 0, we don't pop up menus when
       * the user clicks in a view. */
      int                 last_count;
      int                 x, y, w, h;
      struct
      {
	 int                 x, y;
      }
      down;
      
      struct
      {
	 struct
	 {
	    int                 r, g, b, a;
	 }
	 edge_l             , edge_r, edge_t, edge_b,
	    middle, grad_l, grad_r, grad_t, grad_b;
	 struct
	 {
	    int                 l, r, t, b;
	 }
	 grad_size;
      }
      config;
      struct
      {
	 Evas_Object         clip;
	 Evas_Object         edge_l;
	 Evas_Object         edge_r;
	 Evas_Object         edge_t;
	 Evas_Object         edge_b;
	 Evas_Object         middle;
	 Evas_Object         grad_l;
	 Evas_Object         grad_r;
	 Evas_Object         grad_t;
	 Evas_Object         grad_b;
      }
      obj;
   }
   select;
   
   struct
   {
      int                 started;
      Window              win;
      int                 x, y;
      struct
      {
	 int                 x, y;
      }
      offset;
      int                 update;
      int                 drop_mode;
      int                 icon_hide;
      int                 icon_show;
      int                 matching_drop_attempt;
   }
   drag;
   struct
   {
      int                 valid;
      double              x1, x2, y1, y2;
   }
   extents;

   E_Background        bg;
   E_View_Layout      *layout;

   struct
   {
      EfsdCmdId           x, y, w, h;
      int                 busy;
   }
   geom_get;

   EfsdCmdId           getbg;

   struct
   {
      E_Scrollbar        *h, *v;
   }
   scrollbar;

   int                 is_listing;

   E_Iconbar          *iconbar;

   Evas_List           icons;

   int                 have_resort_queued;

   int                 changed;

   Evas_List           epplet_contexts;
   Ebits_Object        epplet_layout;
};

/**
 * e_view_init - View event handlers initialization.
 *
 * This function registers event handlers for the views.
 * Views are the windows in which e as a desktop shell
 * displays file icons.
 */
void                e_view_init(void);

void                e_view_selection_update(E_View * v);
void                e_view_deselect_all(E_View *v);
void                e_view_deselect_all_except(E_Icon * not_ic);
Ecore_Event        *e_view_get_current_event(void);
int                 e_view_filter_file(E_View * v, char *file);
void                e_view_icons_get_extents(E_View * v, int *min_x, int *min_y,
					     int *max_x, int *max_y);
void                e_view_icons_apply_xy(E_View * v);
void                e_view_scroll_to(E_View * v, int sx, int sy);
void                e_view_scroll_by(E_View * v, int sx, int sy);
void                e_view_scroll_to_percent(E_View * v, double psx,
					     double psy);
void                e_view_get_viewable_percentage(E_View * v, double *vw,
						   double *vh);
void                e_view_get_position_percentage(E_View * v, double *vx,
						   double *vy);

void                e_view_resort_alphabetical(E_View * v);
void                e_view_arrange(E_View * v);
void                e_view_resort(E_View * v);
void                e_view_queue_geometry_record(E_View * v);
void                e_view_queue_icon_xy_record(E_View * v);
void                e_view_queue_resort(E_View * v);

/**
 * e_view_new - Creates a new view object
 * 
 * This function creates a new view and sets default
 * properties on it, such as colors and icon spacings.
 */
E_View             *e_view_new(void);

/**
 * e_view_set_dir - Sets view to a given directory
 * @v          The view for which to set the directory
 * @dir        The directory to set the view to
 * @is_desktop Inidicates wether the view is a desktop  
 *
 * This function sets a view to a directory, loading the
 * view's metadata (view window coordinates etc). If a dir already
 * exists for this dir, it is reused, otherwise a new on is created.
 */
void                e_view_set_dir(E_View * v, char *dir, int is_desktop);

/**
 * e_view_populate - Draws icons for all files in view
 * @v     The view to populate
 *
 * Goes through the list of files in the underlying dir and calls
 * view_add_file for each one. This results in icons being created for each
 * file.
 */
void                e_view_populate(E_View * v);

/**
 * e_view_realize - Initializes a view's graphics and content
 * @v:    The view to initialize
 *
 * This function initializes a created view by loading
 * all the graphics and creating the evas. 
 */
void                e_view_realize(E_View * v);

/**
 * e_view_update - Redraws a view
 * @v:    The view to redraw
 *
 * If the contents of the view have changed, this function redraws it.
 */
void                e_view_update(E_View * v);

void                e_view_bg_reload(E_View * v);
void                e_view_ib_reload(E_View * v);

void                e_view_file_add(E_View * v, E_File * file);
void                e_view_file_changed(E_View * v, E_File * file);
void                e_view_file_delete(E_View * v, E_File * file);

void                e_view_close_all(void);

#endif