![]() |
![]() |
Public Member Functions | ||||
Event (const Event& other) | ||||
Event (GdkEvent* gobject, bool make_a_copy=true) | ||||
Event () | ||||
bool | get_axis (AxisUse axis_use, double& value) const | |||
Extract the axis value for a particular axis use from an event structure. | ||||
bool | get_coords (double& x_win, double& y_win) const | |||
Extract the event window relative x/y coordinates from an event. | ||||
bool | get_root_coords (double& x_root, double& y_root) const | |||
Extract the root window relative x/y coordinates from an event. | ||||
Glib::RefPtr<const Screen> | get_screen () const | |||
Returns the screen for the event. | ||||
Glib::RefPtr<Screen> | get_screen () | |||
Returns the screen for the event. | ||||
bool | get_state (ModifierType& state) const | |||
If the event contains a "state" field, puts that field in state . | ||||
guint32 | get_time () const | |||
Returns the time stamp from event , if there is one; otherwise returns Gdk::CURRENT_TIME. | ||||
const GdkEvent* | gobj () const | |||
Provides access to the underlying C instance. | ||||
GdkEvent* | gobj () | |||
Provides access to the underlying C instance. | ||||
GdkEvent* | gobj_copy () const | |||
Provides access to the underlying C instance. The caller is responsible for freeing it. Use when directly setting fields in structs. | ||||
Event& | operator= (const Event& other) | |||
void | put () | |||
Appends a copy of the given event onto the front of the event queue for event->any.window's display, or the default event queue if event->any.window is 0 . | ||||
bool | send_client_message (const Glib::RefPtr<Display>& display, NativeWindow winid) | |||
bool | send_client_message (NativeWindow winid) | |||
Sends an X ClientMessage event to a given window (which must be on the default Gdk::Display. | ||||
void | set_screen (const Glib::RefPtr<Screen>& screen) | |||
Sets the screen for event to screen . | ||||
void | swap (Event& other) | |||
~Event () | ||||
Static Public Member Functions | ||||
static bool | events_pending () | |||
Checks if any events are ready to be processed for any display. | ||||
static Event | get () | |||
Checks all open displays for a Gdk::Event to process,to be processed on, fetching events from the windowing system if necessary. | ||||
static Event | get_graphics_expose (const Glib::RefPtr<Window>& window) | |||
Waits for a GraphicsExpose or NoExpose event from the X server. | ||||
static bool | get_show_events () | |||
Gets whether event debugging output is enabled. | ||||
static Event | peek () | |||
If there is an event waiting in the event queue of some open display, returns a copy of it. | ||||
static void | set_show_events (bool show_events) | |||
Sets whether a trace of received events is output. | ||||
Protected Attributes | ||||
GdkEvent* | gobject_ | |||
Related Functions | ||||
(Note that these are not member functions.) | ||||
void | swap (Event& lhs, Event& rhs) | |||
| ||||
Gdk::Event | wrap (GdkEvent* object, bool take_copy=false) | |||
A Glib::wrap() method for this object. |
Gdk::Event::Event | ( | ) |
Gdk::Event::Event | ( | GdkEvent * | gobject, | |
bool | make_a_copy = true | |||
) | [explicit] |
Gdk::Event::Event | ( | const Event& | other | ) |
Gdk::Event::~Event | ( | ) |
static bool Gdk::Event::events_pending | ( | ) | [static] |
Checks if any events are ready to be processed for any display.
true
if any events are pending. static Event Gdk::Event::get | ( | ) | [static] |
Checks all open displays for a Gdk::Event to process,to be processed on, fetching events from the windowing system if necessary.
See Gdk::Display::get_event().
0
if no events are pending. The returned Gdk::Event should be freed with gdk_event_free(). bool Gdk::Event::get_axis | ( | AxisUse | axis_use, | |
double & | value | |||
) | const |
Extract the axis value for a particular axis use from an event structure.
axis_use | The axis use to look for. | |
value | Location to store the value found. |
true
if the specified axis was found, otherwise false
. bool Gdk::Event::get_coords | ( | double & | x_win, | |
double & | y_win | |||
) | const |
Extract the event window relative x/y coordinates from an event.
x_win | Location to put event window x coordinate. | |
y_win | Location to put event window y coordinate. |
true
if the event delivered event window coordinates. static Event Gdk::Event::get_graphics_expose | ( | const Glib::RefPtr<Window>& | window | ) | [static] |
Waits for a GraphicsExpose or NoExpose event from the X server.
This is used in the Gtk::Text and Gtk::CList widgets in GTK+ to make sure any GraphicsExpose events are handled before the widget is scrolled.
window | The Gdk::Window to wait for the events for. |
0
if a NoExpose event was received. bool Gdk::Event::get_root_coords | ( | double & | x_root, | |
double & | y_root | |||
) | const |
Extract the root window relative x/y coordinates from an event.
x_root | Location to put root window x coordinate. | |
y_root | Location to put root window y coordinate. |
true
if the event delivered root window coordinates. Glib::RefPtr<const Screen> Gdk::Event::get_screen | ( | ) | const |
Returns the screen for the event.
The screen is typically the screen for event->any.window
, but for events such as mouse events, it is the screen where the pointer was when the event occurs - that is, the screen which has the root window to which event->motion.x_root
and event->motion.y_root
are relative.
Glib::RefPtr<Screen> Gdk::Event::get_screen | ( | ) |
Returns the screen for the event.
The screen is typically the screen for event->any.window
, but for events such as mouse events, it is the screen where the pointer was when the event occurs - that is, the screen which has the root window to which event->motion.x_root
and event->motion.y_root
are relative.
static bool Gdk::Event::get_show_events | ( | ) | [static] |
Gets whether event debugging output is enabled.
true
if event debugging output is enabled. bool Gdk::Event::get_state | ( | ModifierType& | state | ) | const |
If the event contains a "state" field, puts that field in state .
Otherwise stores an empty state (0). Returns true
if there was a state field in the event. event may be 0
, in which case it's treated as if the event had no state field.
state | Return location for state. |
true
if there was a state field in the event. guint32 Gdk::Event::get_time | ( | ) | const |
Returns the time stamp from event , if there is one; otherwise returns Gdk::CURRENT_TIME.
If event is 0
, returns Gdk::CURRENT_TIME.
const GdkEvent* Gdk::Event::gobj | ( | ) | const [inline] |
Provides access to the underlying C instance.
GdkEvent* Gdk::Event::gobj | ( | ) | [inline] |
Provides access to the underlying C instance.
GdkEvent* Gdk::Event::gobj_copy | ( | ) | const |
Provides access to the underlying C instance. The caller is responsible for freeing it. Use when directly setting fields in structs.
static Event Gdk::Event::peek | ( | ) | [static] |
If there is an event waiting in the event queue of some open display, returns a copy of it.
See Gdk::Display::peek_event().
0
if no events are in any queues. The returned Gdk::Event should be freed with gdk_event_free(). void Gdk::Event::put | ( | ) |
Appends a copy of the given event onto the front of the event queue for event->any.window's display, or the default event queue if event->any.window is 0
.
bool Gdk::Event::send_client_message | ( | const Glib::RefPtr<Display>& | display, | |
NativeWindow | winid | |||
) |
bool Gdk::Event::send_client_message | ( | NativeWindow | winid | ) |
Sends an X ClientMessage event to a given window (which must be on the default Gdk::Display.
) This could be used for communicating between different applications, though the amount of data is limited to 20 bytes.
winid | The window to send the X ClientMessage event to. |
void Gdk::Event::set_screen | ( | const Glib::RefPtr<Screen>& | screen | ) |
Sets the screen for event to screen .
The event must have been allocated by GTK+, for instance, by gdk_event_copy().
screen | A Gdk::Screen. |
static void Gdk::Event::set_show_events | ( | bool | show_events | ) | [static] |
Sets whether a trace of received events is output.
Note that GTK+ must be compiled with debugging (that is, configured using the <option>--enable-debug</option> option) to use this option.
show_events | true to output event debugging information. |
void Gdk::Event::swap | ( | Event& | other | ) |
lhs | The left-hand side |
rhs | The right-hand side |
Gdk::Event wrap | ( | GdkEvent * | object, | |
bool | take_copy = false | |||
) | [related] |
A Glib::wrap() method for this object.
object | The C instance. | |
take_copy | False if the result should take ownership of the C instance. True if it should take a new copy or ref. |
GdkEvent* Gdk::Event::gobject_ [protected] |