📄 gdk-events.html
字号:
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head><meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"><title>Events</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="GDK Reference Manual"><link rel="up" href="reference.html" title="API Reference"><link rel="prev" href="gdk-Windows.html" title="Windows"><link rel="next" href="gdk-Event-Structures.html" title="Event Structures"><meta name="generator" content="GTK-Doc V1.9 (XML mode)"><link rel="stylesheet" href="style.css" type="text/css"><link rel="reference" href="reference.html" title="API Reference"><link rel="index" href="ix01.html" title="Index"><link rel="index" href="ix02.html" title="Index of deprecated symbols"><link rel="index" href="ix03.html" title="Index of new symbols in 2.2"><link rel="index" href="ix04.html" title="Index of new symbols in 2.4"><link rel="index" href="ix05.html" title="Index of new symbols in 2.6"><link rel="index" href="ix06.html" title="Index of new symbols in 2.8"><link rel="index" href="ix07.html" title="Index of new symbols in 2.10"><link rel="index" href="ix08.html" title="Index of new symbols in 2.12"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="gdk-Windows.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="reference.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">GDK Reference Manual</th><td><a accesskey="n" href="gdk-Event-Structures.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr><tr><td colspan="5" class="shortcuts"><nobr><a href="#id3227421" class="shortcut">Top</a>  |  <a href="#id3228160" class="shortcut">Description</a></nobr></td></tr></table><div class="refentry" lang="en"><a name="gdk-Events"></a><div class="titlepage"></div><div class="refnamediv"><table width="100%"><tr><td valign="top"><h2><a name="id3227421"></a><span class="refentrytitle">Events</span></h2><p>Events — Functions for handling events from the window system</p></td><td valign="top" align="right"></td></tr></table></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">#include <gdk/gdk.h>enum <a class="link" href="gdk-Events.html#GdkEventType">GdkEventType</a>;enum <a class="link" href="gdk-Events.html#GdkEventMask">GdkEventMask</a>;#define <a class="link" href="gdk-Events.html#GDK-CURRENT-TIME:CAPS">GDK_CURRENT_TIME</a>#define <a class="link" href="gdk-Events.html#GDK-PRIORITY-EVENTS:CAPS">GDK_PRIORITY_EVENTS</a>#define <a class="link" href="gdk-Events.html#GDK-PRIORITY-REDRAW:CAPS">GDK_PRIORITY_REDRAW</a><ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gdk-Events.html#gdk-events-pending">gdk_events_pending</a> (void);<a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a>* <a class="link" href="gdk-Events.html#gdk-event-peek">gdk_event_peek</a> (void);<a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a>* <a class="link" href="gdk-Events.html#gdk-event-get">gdk_event_get</a> (void);<a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a>* <a class="link" href="gdk-Events.html#gdk-event-get-graphics-expose">gdk_event_get_graphics_expose</a> (<a class="link" href="gdk-Windows.html#GdkWindow">GdkWindow</a> *window);void <a class="link" href="gdk-Events.html#gdk-event-put">gdk_event_put</a> (<a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event);<a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a>* <a class="link" href="gdk-Events.html#gdk-event-new">gdk_event_new</a> (<a class="link" href="gdk-Events.html#GdkEventType">GdkEventType</a> type);<a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a>* <a class="link" href="gdk-Events.html#gdk-event-copy">gdk_event_copy</a> (<a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event);void <a class="link" href="gdk-Events.html#gdk-event-free">gdk_event_free</a> (<a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event);<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32">guint32</a> <a class="link" href="gdk-Events.html#gdk-event-get-time">gdk_event_get_time</a> (<a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event);<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gdk-Events.html#gdk-event-get-state">gdk_event_get_state</a> (<a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event, <a class="link" href="gdk-Windows.html#GdkModifierType">GdkModifierType</a> *state);<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gdk-Events.html#gdk-event-get-axis">gdk_event_get_axis</a> (<a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event, <a class="link" href="gdk-Input-Devices.html#GdkAxisUse">GdkAxisUse</a> axis_use, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble">gdouble</a> *value);<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gdk-Events.html#gdk-event-get-coords">gdk_event_get_coords</a> (<a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble">gdouble</a> *x_win, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble">gdouble</a> *y_win);<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gdk-Events.html#gdk-event-get-root-coords">gdk_event_get_root_coords</a> (<a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble">gdouble</a> *x_root, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble">gdouble</a> *y_root);void <a class="link" href="gdk-Events.html#gdk-event-request-motions">gdk_event_request_motions</a> (<a class="link" href="gdk-Event-Structures.html#GdkEventMotion">GdkEventMotion</a> *event);void <a class="link" href="gdk-Events.html#gdk-event-handler-set">gdk_event_handler_set</a> (<a class="link" href="gdk-Events.html#GdkEventFunc">GdkEventFunc</a> func, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> data, <ahref="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> notify);void (<a class="link" href="gdk-Events.html#GdkEventFunc">*GdkEventFunc</a>) (<a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> data);<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gdk-Events.html#gdk-event-send-client-message">gdk_event_send_client_message</a> (<a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event, <a class="link" href="gdk-Event-Structures.html#GdkNativeWindow">GdkNativeWindow</a> winid);<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gdk-Events.html#gdk-event-send-client-message-for-display">gdk_event_send_client_message_for_display</a> (<a class="link" href="GdkDisplay.html" title="GdkDisplay">GdkDisplay</a> *display, <a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event, <a class="link" href="gdk-Event-Structures.html#GdkNativeWindow">GdkNativeWindow</a> winid);void <a class="link" href="gdk-Events.html#gdk-event-send-clientmessage-toall">gdk_event_send_clientmessage_toall</a> (<a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event);void <a class="link" href="gdk-Events.html#gdk-add-client-message-filter">gdk_add_client_message_filter</a> (<a class="link" href="gdk-Properties-and-Atoms.html#GdkAtom">GdkAtom</a> message_type, <a class="link" href="gdk-Windows.html#GdkFilterFunc">GdkFilterFunc</a> func, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> data);<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gdk-Events.html#gdk-get-show-events">gdk_get_show_events</a> (void);void <a class="link" href="gdk-Events.html#gdk-set-show-events">gdk_set_show_events</a> (<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> show_events);void <a class="link" href="gdk-Events.html#gdk-event-set-screen">gdk_event_set_screen</a> (<a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event, <a class="link" href="GdkScreen.html" title="GdkScreen">GdkScreen</a> *screen);<a class="link" href="GdkScreen.html" title="GdkScreen">GdkScreen</a>* <a class="link" href="gdk-Events.html#gdk-event-get-screen">gdk_event_get_screen</a> (<a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event);<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gdk-Events.html#gdk-setting-get">gdk_setting_get</a> (const <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *name, <ahref="/usr/share/gtk-doc/html/gobject/gobject-Generic-values.html#GValue">GValue</a> *value);</pre></div><div class="refsect1" lang="en"><a name="id3228160"></a><h2>Description</h2><p>This section describes functions dealing with events from the window system.</p><p>In GTK+ applications the events are handled automatically in<ahref="/usr/share/gtk-doc/html/gtk/gtk-General.html#gtk-main-do-event"><code class="function">gtk_main_do_event()</code></a> and passed on to the appropriate widgets, so thesefunctions are rarely needed. Though some of the fields in the<a class="link" href="gdk-Event-Structures.html" title="Event Structures">Event Structures</a> are useful.</p></div><div class="refsect1" lang="en"><a name="id3228203"></a><h2>Details</h2><div class="refsect2" lang="en"><a name="id3228214"></a><h3><a name="GdkEventType"></a>enum GdkEventType</h3><a class="indexterm" name="id3228226"></a><pre class="programlisting">typedef enum{ GDK_NOTHING = -1, GDK_DELETE = 0, GDK_DESTROY = 1, GDK_EXPOSE = 2, GDK_MOTION_NOTIFY = 3, GDK_BUTTON_PRESS = 4, GDK_2BUTTON_PRESS = 5, GDK_3BUTTON_PRESS = 6, GDK_BUTTON_RELEASE = 7, GDK_KEY_PRESS = 8, GDK_KEY_RELEASE = 9, GDK_ENTER_NOTIFY = 10, GDK_LEAVE_NOTIFY = 11, GDK_FOCUS_CHANGE = 12, GDK_CONFIGURE = 13, GDK_MAP = 14, GDK_UNMAP = 15, GDK_PROPERTY_NOTIFY = 16, GDK_SELECTION_CLEAR = 17, GDK_SELECTION_REQUEST = 18, GDK_SELECTION_NOTIFY = 19, GDK_PROXIMITY_IN = 20, GDK_PROXIMITY_OUT = 21, GDK_DRAG_ENTER = 22, GDK_DRAG_LEAVE = 23, GDK_DRAG_MOTION = 24, GDK_DRAG_STATUS = 25, GDK_DROP_START = 26, GDK_DROP_FINISHED = 27, GDK_CLIENT_EVENT = 28, GDK_VISIBILITY_NOTIFY = 29, GDK_NO_EXPOSE = 30, GDK_SCROLL = 31, GDK_WINDOW_STATE = 32, GDK_SETTING = 33, GDK_OWNER_CHANGE = 34, GDK_GRAB_BROKEN = 35} GdkEventType;</pre><p>Specifies the type of the event.</p><p>Do not confuse these events with the signals that GTK+ widgets emit.Although many of these events result in corresponding signals being emitted,the events are often transformed or filtered along the way.</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><a name="GDK-NOTHING:CAPS"></a><code class="literal">GDK_NOTHING</code></span></p></td><td>a special code to indicate a null event.</td></tr><tr><td><p><span class="term"><a name="GDK-DELETE:CAPS"></a><code class="literal">GDK_DELETE</code></span></p></td><td>the window manager has requested that the toplevel window behidden or destroyed, usually when the user clicks on a special icon in thetitle bar.</td></tr><tr><td><p><span class="term"><a name="GDK-DESTROY:CAPS"></a><code class="literal">GDK_DESTROY</code></span></p></td><td>the window has been destroyed.</td></tr><tr><td><p><span class="term"><a name="GDK-EXPOSE:CAPS"></a><code class="literal">GDK_EXPOSE</code></span></p></td><td>all or part of the window has become visible and needs to beredrawn.</td></tr><tr><td><p><span class="term"><a name="GDK-MOTION-NOTIFY:CAPS"></a><code class="literal">GDK_MOTION_NOTIFY</code></span></p></td><td>the pointer (usually a mouse) has moved.</td></tr><tr><td><p><span class="term"><a name="GDK-BUTTON-PRESS:CAPS"></a><code class="literal">GDK_BUTTON_PRESS</code></span></p></td><td>a mouse button has been pressed.</td></tr><tr><td><p><span class="term"><a name="GDK-2BUTTON-PRESS:CAPS"></a><code class="literal">GDK_2BUTTON_PRESS</code></span></p></td><td>a mouse button has been double-clicked (clicked twicewithin a short period of time). Note that each click also generates a<a class="link" href="gdk-Events.html#GDK-BUTTON-PRESS:CAPS"><code class="literal">GDK_BUTTON_PRESS</code></a> event.</td></tr><tr><td><p><span class="term"><a name="GDK-3BUTTON-PRESS:CAPS"></a><code class="literal">GDK_3BUTTON_PRESS</code></span></p></td><td>a mouse button has been clicked 3 times in a short periodof time. Note that each click also generates a <a class="link" href="gdk-Events.html#GDK-BUTTON-PRESS:CAPS"><code class="literal">GDK_BUTTON_PRESS</code></a> event.</td></tr><tr><td><p><span class="term"><a name="GDK-BUTTON-RELEASE:CAPS"></a><code class="literal">GDK_BUTTON_RELEASE</code></span></p></td><td>a mouse button has been released.</td></tr><tr><td><p><span class="term"><a name="GDK-KEY-PRESS:CAPS"></a><code class="literal">GDK_KEY_PRESS</code></span></p></td><td>a key has been pressed.</td></tr><tr><td><p><span class="term"><a name="GDK-KEY-RELEASE:CAPS"></a><code class="literal">GDK_KEY_RELEASE</code></span></p></td><td>a key has been released.</td></tr><tr>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -