X-Git-Url: https://git.dogcows.com/gitweb?a=blobdiff_plain;f=openbox%2Fevent.h;h=cc441405a4638e582f0119149ec76b5ff991981a;hb=HEAD;hp=65ff915bc5f76d4b7c84477ce33746cb9d7f43ec;hpb=ceb77efdd44e993b1ed4e9d908f93baf22b2b22c;p=chaz%2Fopenbox diff --git a/openbox/event.h b/openbox/event.h index 65ff915b..cc441405 100644 --- a/openbox/event.h +++ b/openbox/event.h @@ -25,11 +25,9 @@ struct _ObClient; /*! The amount of time before a window appears that is checked for user input - to determine if the user is working in another window */ -#define OB_EVENT_USER_TIME_DELAY (500) /* 0.5 seconds */ + to determine if the user is working in another window */ +#define OB_EVENT_USER_TIME_DELAY (1000) /* milliseconds */ -/*! Time at which the last event with a timestamp occured. */ -extern Time event_curtime; /*! The last user-interaction time, as given by the clients */ extern Time event_last_user_time; @@ -37,25 +35,57 @@ void event_startup(gboolean reconfig); void event_shutdown(gboolean reconfig); /*! Make as if the mouse just entered the client, use only when using focus - follows mouse */ + follows mouse */ void event_enter_client(struct _ObClient *client); +/*! Make as if the mouse just left the client, use only when using focus + follows mouse */ +void event_leave_client(struct _ObClient *client); + /*! Make mouse focus not move at all from the stuff that happens between these - two function calls. */ -gulong event_start_ignore_all_enters(); + two function calls. */ +gulong event_start_ignore_all_enters(void); void event_end_ignore_all_enters(gulong start); -/*! End *all* active and passive grabs on the keyboard */ -void event_cancel_all_key_grabs(); +/*! End *all* active and passive grabs on the keyboard + This is called in situations where if there is a grab going on, then + we need to cancel it. If we move focus during the grab, applications + will get NotifyWhileGrabbed events and ignore them! + + Actions should not rely on being able to move focus during an + interactive grab. */ +void event_cancel_all_key_grabs(void); /* Halts any focus delay in progress, use this when the user is selecting a window for focus */ -void event_halt_focus_delay(); +void event_halt_focus_delay(void); /*! Compare t1 and t2, taking into account wraparound. True if t1 - comes at the same time or later than t2. */ -gboolean event_time_after(Time t1, Time t2); + comes at the same time or later than t2. */ +gboolean event_time_after(guint32 t1, guint32 t2); + +/*! Time at which the current event occured. If this is not known, this + is a time at or after it, but at or before any other events we will process +*/ +Time event_time(void); + +/*! Force event_time() to skip the current timestamp and look for the next + one. */ +void event_reset_time(void); + +/*! A time at which an event happened that caused this current event to be + generated. This is a user-provided time and not to be trusted. + Returns CurrentTime if there was no source time provided. +*/ +Time event_source_time(void); + +/*! Update the timestamp for when the user has last used the focused window. + This updates the timestamp to the time of the last event, given by + event_time(). +*/ +void event_update_user_time(void); -Time event_get_server_time(); +/*! Reset the timestamp for when the user has last used the focused window. */ +void event_reset_user_time(void); #endif