gdk-events.html

最新gtk中文资料集

</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-SUBSTRUCTURE-MASK:CAPS"></a><code class="literal">GDK_SUBSTRUCTURE_MASK</code></span></p></td>
<td>receive events about window configuration changes of 
  child windows
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-SCROLL-MASK:CAPS"></a><code class="literal">GDK_SCROLL_MASK</code></span></p></td>
<td>receive scroll events
</td>
</tr>
<tr>
<td><p><span class="term"><a name="GDK-ALL-EVENTS-MASK:CAPS"></a><code class="literal">GDK_ALL_EVENTS_MASK</code></span></p></td>
<td>the combination of all the above event masks.

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3229835"></a><h3>
<a name="GDK-CURRENT-TIME:CAPS"></a>GDK_CURRENT_TIME</h3>
<a class="indexterm" name="id3229848"></a><pre class="programlisting">#define GDK_CURRENT_TIME     0L
</pre>
<p>
Represents the current time, and can be used anywhere a time is expected.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3229865"></a><h3>
<a name="GDK-PRIORITY-EVENTS:CAPS"></a>GDK_PRIORITY_EVENTS</h3>
<a class="indexterm" name="id3229878"></a><pre class="programlisting">#define             GDK_PRIORITY_EVENTS</pre>
<p>
This is the priority that events from the X server are given in the
<a
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html"
>GLib Main Loop</a>.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3229903"></a><h3>
<a name="GDK-PRIORITY-REDRAW:CAPS"></a>GDK_PRIORITY_REDRAW</h3>
<a class="indexterm" name="id3229917"></a><pre class="programlisting">#define GDK_PRIORITY_REDRAW     (G_PRIORITY_HIGH_IDLE + 20)
</pre>
<p>
This is the priority that the idle handler processing window updates
is given in the <a
href="/usr/share/gtk-doc/html/glib/glib-The-Main-Event-Loop.html"
>GLib Main Loop</a>.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3229941"></a><h3>
<a name="gdk-events-pending"></a>gdk_events_pending ()</h3>
<a class="indexterm" name="id3229954"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gdk_events_pending                  (void);</pre>
<p>
Checks if any events are ready to be processed for any display.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>  <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if any events are pending.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3230005"></a><h3>
<a name="gdk-event-peek"></a>gdk_event_peek ()</h3>
<a class="indexterm" name="id3230018"></a><pre class="programlisting"><a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a>*           gdk_event_peek                      (void);</pre>
<p>
If there is an event waiting in the event queue of some open
display, returns a copy of it. See <a class="link" href="GdkDisplay.html#gdk-display-peek-event"><code class="function">gdk_display_peek_event()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a copy of the first <a class="link" href="gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> on some event queue, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> if no
events are in any queues. The returned <a class="link" href="gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> should be freed with
<a class="link" href="gdk-Events.html#gdk-event-free"><code class="function">gdk_event_free()</code></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3230108"></a><h3>
<a name="gdk-event-get"></a>gdk_event_get ()</h3>
<a class="indexterm" name="id3230121"></a><pre class="programlisting"><a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a>*           gdk_event_get                       (void);</pre>
<p>
Checks all open displays for a <a class="link" href="gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> to process,to be processed
on, fetching events from the windowing system if necessary.
See <a class="link" href="GdkDisplay.html#gdk-display-get-event"><code class="function">gdk_display_get_event()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the next <a class="link" href="gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> to be processed, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> if no events
are pending. The returned <a class="link" href="gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> should be freed with <a class="link" href="gdk-Events.html#gdk-event-free"><code class="function">gdk_event_free()</code></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3230219"></a><h3>
<a name="gdk-event-get-graphics-expose"></a>gdk_event_get_graphics_expose ()</h3>
<a class="indexterm" name="id3230232"></a><pre class="programlisting"><a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a>*           gdk_event_get_graphics_expose       (<a class="link" href="gdk-Windows.html#GdkWindow">GdkWindow</a> *window);</pre>
<p>
Waits for a GraphicsExpose or NoExpose event from the X server.
This is used in the <a
href="/usr/share/gtk-doc/html/gtk/GtkText.html"
><span class="type">GtkText</span></a> and <a
href="/usr/share/gtk-doc/html/gtk/GtkCList.html"
><span class="type">GtkCList</span></a> widgets in GTK+ to make sure any
GraphicsExpose events are handled before the widget is scrolled.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>window</code></em>&#160;:</span></p></td>
<td> the <a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> to wait for the events for.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>  a <a class="link" href="gdk-Event-Structures.html#GdkEventExpose"><span class="type">GdkEventExpose</span></a> if a GraphicsExpose was received, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> if a
NoExpose event was received.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3230341"></a><h3>
<a name="gdk-event-put"></a>gdk_event_put ()</h3>
<a class="indexterm" name="id3230354"></a><pre class="programlisting">void                gdk_event_put                       (<a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event);</pre>
<p>
Appends a copy of the given event onto the front of the event
queue for event-&gt;any.window's display, or the default event
queue if event-&gt;any.window is <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>. See <a class="link" href="GdkDisplay.html#gdk-display-put-event"><code class="function">gdk_display_put_event()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>event</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3230435"></a><h3>
<a name="gdk-event-new"></a>gdk_event_new ()</h3>
<a class="indexterm" name="id3230450"></a><pre class="programlisting"><a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a>*           gdk_event_new                       (<a class="link" href="gdk-Events.html#GdkEventType">GdkEventType</a> type);</pre>
<p>
Creates a new event of the given type. All fields are set to 0.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>type</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gdk-Events.html#GdkEventType"><span class="type">GdkEventType</span></a> 
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a newly-allocated <a class="link" href="gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a>. The returned <a class="link" href="gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> 
should be freed with <a class="link" href="gdk-Events.html#gdk-event-free"><code class="function">gdk_event_free()</code></a>.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3230553"></a><h3>
<a name="gdk-event-copy"></a>gdk_event_copy ()</h3>
<a class="indexterm" name="id3230566"></a><pre class="programlisting"><a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a>*           gdk_event_copy                      (<a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event);</pre>
<p>
Copies a <a class="link" href="gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a>, copying or incrementing the reference count of the
resources associated with it (e.g. <a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a>'s and strings).</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>event</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a copy of <em class="parameter"><code>event</code></em>. The returned <a class="link" href="gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> should be freed with
<a class="link" href="gdk-Events.html#gdk-event-free"><code class="function">gdk_event_free()</code></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3230676"></a><h3>
<a name="gdk-event-free"></a>gdk_event_free ()</h3>
<a class="indexterm" name="id3230689"></a><pre class="programlisting">void                gdk_event_free                      (<a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event);</pre>
<p>
Frees a <a class="link" href="gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a>, freeing or decrementing any resources associated with it.
Note that this function should only be called with events returned from
functions such as <a class="link" href="gdk-Events.html#gdk-event-peek"><code class="function">gdk_event_peek()</code></a>, <a class="link" href="gdk-Events.html#gdk-event-get"><code class="function">gdk_event_get()</code></a>,
<a class="link" href="gdk-Events.html#gdk-event-get-graphics-expose"><code class="function">gdk_event_get_graphics_expose()</code></a> and <a class="link" href="gdk-Events.html#gdk-event-copy"><code class="function">gdk_event_copy()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>event</code></em>&#160;:</span></p></td>
<td>  a <a class="link" href="gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3230799"></a><h3>
<a name="gdk-event-get-time"></a>gdk_event_get_time ()</h3>
<a class="indexterm" name="id3230813"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
>guint32</a>             gdk_event_get_time                  (<a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event);</pre>
<p>
Returns the time stamp from <em class="parameter"><code>event</code></em>, if there is one; otherwise
returns <a class="link" href="gdk-Events.html#GDK-CURRENT-TIME:CAPS"><span class="type">GDK_CURRENT_TIME</span></a>. If <em class="parameter"><code>event</code></em> is <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>, returns <a class="link" href="gdk-Events.html#GDK-CURRENT-TIME:CAPS"><span class="type">GDK_CURRENT_TIME</span></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>event</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> time stamp field from <em class="parameter"><code>event</code></em>
</td>
</tr>