enlightenment/src/border.h

262 lines
6.5 KiB
C
Raw Normal View History

#ifndef E_BORDER_H
#define E_BORDER_H
#include "e.h"
Alright, I spent some time now reading e17's code. Here's what I've changed, this is big, so read this carefully :) * I've added debugging macros for messages and function call tracing. Usage: D("Creating item %i %i %i\n", x, y, z); Define DEBUG to use the D macro. D_ENTER; D_RETURN; D_RETURN_(x); These are for call tracing. Use D_RETURN_(x) when returning something from a function. Define DEBUG_NEST to use this. * added iconbar header file to Makefile.am * added proper new()/cleanup() calls for E_Delayed_Action; * I've completely rewritten the object and observer handling. Bye bye macros, this was nasty. It'll be hard enough to avoid leaks with usecounting in C. We now basically have the same system as gtk. There's a clear separation of observer and object code now. An E_Object by itself has nothing to do with observing or being observed, therefore, there are now E_Observers and E_Observees that are derived from E_Object. IMPORTANT: The cleanup system now reflects the reference count system, therefore, all ..._free() calls are now static, because the destructor should never be called explicitly, but implicitly through e_object_unref(). The object handling now is as follows: - The cleanup functions clean up everything that is contained in a struct, but NOT the struct itself. Instead of the final free() call, they call the destructor of the base class. The calls will walk up the hierarchy and clean up what's contained in every struct, and the final e_object_cleanup() will free the structure itself. E_Delayed_Action is a good example. - The only calls that influence the reference count are e_object_ref() and e_object_unref(). If you need to do things before an object gets destroyed, you can query the use count using e_object_get_usecount() and check if it's equal to 1. So this: OBJ_UNREF(b); OBJ_IF_FREE(b) { ecore_window_reparent(e->win, 0, 0, 0); e_icccm_release(e->win); OBJ_FREE(b); } now is this: if (e_object_get_usecount(E_OBJECT(b)) == 1) { ecore_window_reparent(e->win, 0, 0, 0); e_icccm_release(e->win); } e_object_unref(E_OBJECT(b)); object.h and observer.h are completely commented, it shouldn't be too hard to understand. This'll need to be documented in the manual anyway. * E_Objects are now used in lots of places where void* were used as pointers to objects before, especially in the actions code. This is obviously better, as it will generate compiler warnings when people want to pass things to functions that expect E_Objects. This could probably be more restrictive. * Added typedefs for the function prototypes in E_Action_Impl. Those fat signatures were just painful to read in the function declarations/implementations. * I've also tried to give parameters more useful names. Calling an object "o" is a lot of fun when you want to grep for it. * Included is also Graham's latest menu.c patch. Sorry for the delay, Graham. * I've added checks to the menu code that make sure that menus don't pop up when they're empty (which resulted in a little useless rectangle). I guess that's it for now. Sorry if I broke anything, but this was necessary imho. SVN revision: 5605
2001-11-02 09:07:52 -08:00
#include "observer.h"
#include "debug.h"
#include "text.h"
#ifndef E_DESKTOPS_TYPEDEF
#define E_DESKTOPS_TYPEDEF
typedef struct _E_Desktop E_Desktop;
#endif
typedef struct _E_Grab E_Grab;
typedef struct _E_Border E_Border;
struct _E_Grab
{
int button;
Ecore_Event_Key_Modifiers mods;
int any_mod;
int remove_after;
int allow;
};
struct _E_Border
{
E_Observee obs;
struct
{
Window main;
Window b;
Window input;
Window container;
Window client;
}
win;
2003-01-15 10:29:56 -08:00
Evas *evas;
struct
{
E_Text *title;
2003-01-15 10:29:56 -08:00
Evas_Object *title_clip;
}
obj;
2003-01-15 10:29:56 -08:00
Evas_List *windows;
struct
{
int new;
Ebits_Object b;
}
bits;
struct
{
struct
{
int x, y, w, h;
int visible;
int dx, dy;
}
requested;
int x, y, w, h;
int visible;
int selected;
int select_lost_from_grab;
int shaded;
int has_shape;
int shape_changes;
int shaped_client;
}
current , previous;
struct
{
struct
{
int w, h;
double aspect;
}
base , min, max, step;
int layer;
char *title;
char *name;
char *class;
char *command;
char *machine;
char *icon_name;
int pid;
Window group;
int takes_focus;
int sticky;
Colormap colormap;
int fixed;
int arrange_ignore;
int hidden;
int iconified;
int titlebar;
int border;
int handles;
int initial_state;
int is_desktop;
int w, h;
int no_place;
struct
{
int launch_id;
pid_t pid;
pid_t ppid;
uid_t user;
}
e;
struct
{
int requested;
int x, y;
int gravity;
}
pos;
int desk;
struct
{
int x, y;
}
area;
int internal;
struct
{
int matched;
struct
{
int matched;
int ignore;
}
prog_location;
struct
{
int matched;
char *style;
}
border;
struct
{
int matched;
int x, y;
}
location;
struct
{
int matched;
int x, y;
}
desk_area;
struct
{
int matched;
int w, h;
}
size;
struct
{
int matched;
int desk;
}
desktop;
struct
{
int matched;
int sticky;
}
sticky;
struct
{
int matched;
int layer;
}
layer;
}
matched;
}
client;
struct
{
int move, resize;
}
mode;
struct
{
int x, y, w, h;
int is;
}
max;
int ignore_unmap;
int shape_changed;
int placed;
E_Grab *click_grab;
E_Desktop *desk;
char *border_style;
char *border_file;
int first_expose;
int hold_changes;
int changed;
};
/**
* e_border_init - Border handling initialization.
*
* This function registers the border event handlers
* against ecore.
*/
void e_border_init(void);
E_Border *e_border_new(void);
void e_border_update_borders(void);
2003-01-15 10:29:56 -08:00
void e_border_redraw_region(E_Border *b, int x, int y,
int w, int h);
void e_border_update_render(E_Border * b);
void e_border_apply_border(E_Border * b);
void e_border_reshape(E_Border * b);
void e_border_release(E_Border * b);
E_Border *e_border_adopt(Window win, int use_client_pos);
void e_border_adopt_children(Window win);
void e_border_remove_mouse_grabs(E_Border * b);
void e_border_remove_click_grab(E_Border * b);
void e_border_attach_mouse_grabs(E_Border * b);
void e_border_remove_all_mouse_grabs(void);
void e_border_attach_all_mouse_grabs(void);
void e_border_redo_grabs(void);
E_Border *e_border_find_by_window(Window win);
void e_border_set_bits(E_Border * b, char *file);
void e_border_set_color_class(E_Border * b, char *class, int rr,
int gg, int bb, int aa);
void e_border_adjust_limits(E_Border * b);
void e_border_update(E_Border * b);
void e_border_set_layer(E_Border * b, int layer);
void e_border_raise(E_Border * b);
void e_border_lower(E_Border * b);
void e_border_iconify(E_Border * b);
void e_border_uniconify(E_Border * b);
void e_border_raise_above(E_Border * b, E_Border * above);
void e_border_lower_below(E_Border * b, E_Border * below);
E_Border *e_border_current_focused(void);
void e_border_focus_grab_ended(void);
void e_border_send_pointer(E_Border * b);
int e_border_viewable(E_Border * b);
void e_border_print_pos(char *buf, E_Border * b);
void e_border_print_size(char *buf, E_Border * b);
void e_border_set_gravity(E_Border * b, int gravity);
2003-01-15 10:29:56 -08:00
Evas_List *e_border_get_borders_list();
void e_borders_scroll_list(Evas_List *borders,
int dx, int dy);
#endif