gdkdisplay.html

来自「最新gtk中文资料集」· HTML 代码 · 共 1,395 行 · 第 1/5 页

requests have been handled. This is often used for making sure that the
display is synchronized with the current state of the program. Calling
<a class="link" href="GdkDisplay.html#gdk-display-sync"><code class="function">gdk_display_sync()</code></a> before <a class="link" href="gdk-General.html#gdk-error-trap-pop"><code class="function">gdk_error_trap_pop()</code></a> makes sure that any errors
generated from earlier requests are handled before the error trap is 
removed.
</p>
<p>
This is most useful for X11. On windowing systems where requests are
handled synchronously, this function will do nothing.</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>display</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a>
</td>
</tr></tbody>
</table></div>
<p class="since">Since  2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3054166"></a><h3>
<a name="gdk-display-flush"></a>gdk_display_flush ()</h3>
<a class="indexterm" name="id3054181"></a><pre class="programlisting">void                gdk_display_flush                   (<a class="link" href="GdkDisplay.html" title="GdkDisplay">GdkDisplay</a> *display);</pre>
<p>
Flushes any requests queued for the windowing system; this happens automatically
when the main loop blocks waiting for new events, but if your application
is drawing without returning control to the main loop, you may need
to call this function explicitely. A common case where this function
needs to be called is when an application is executing drawing commands
from a thread other than the thread where the main loop is running.
</p>
<p>
This is most useful for X11. On windowing systems where requests are
handled synchronously, this function will do nothing.</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>display</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a>
</td>
</tr></tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3054257"></a><h3>
<a name="gdk-display-close"></a>gdk_display_close ()</h3>
<a class="indexterm" name="id3054273"></a><pre class="programlisting">void                gdk_display_close                   (<a class="link" href="GdkDisplay.html" title="GdkDisplay">GdkDisplay</a> *display);</pre>
<p>
Closes the connection to the windowing system for the given display,
and cleans up associated resources.</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>display</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a>
</td>
</tr></tbody>
</table></div>
<p class="since">Since  2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3054338"></a><h3>
<a name="gdk-display-list-devices"></a>gdk_display_list_devices ()</h3>
<a class="indexterm" name="id3054353"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
>GList</a>*              gdk_display_list_devices            (<a class="link" href="GdkDisplay.html" title="GdkDisplay">GdkDisplay</a> *display);</pre>
<p>
Returns the list of available input devices attached to <em class="parameter"><code>display</code></em>.
The list is statically allocated and should not be freed.</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>display</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a list of <a class="link" href="gdk-Input-Devices.html#GdkDevice"><span class="type">GdkDevice</span></a>

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3054443"></a><h3>
<a name="gdk-display-get-event"></a>gdk_display_get_event ()</h3>
<a class="indexterm" name="id3054458"></a><pre class="programlisting"><a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a>*           gdk_display_get_event               (<a class="link" href="GdkDisplay.html" title="GdkDisplay">GdkDisplay</a> *display);</pre>
<p>
Gets the next <a class="link" href="gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> to be processed for <em class="parameter"><code>display</code></em>, fetching events from the
windowing system if necessary.</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>display</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a>
</td>
</tr>
<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>
<p class="since">Since  2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3054587"></a><h3>
<a name="gdk-display-peek-event"></a>gdk_display_peek_event ()</h3>
<a class="indexterm" name="id3054602"></a><pre class="programlisting"><a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a>*           gdk_display_peek_event              (<a class="link" href="GdkDisplay.html" title="GdkDisplay">GdkDisplay</a> *display);</pre>
<p>
Gets a copy of the first <a class="link" href="gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> in the <em class="parameter"><code>display</code></em>'s event queue, without
removing the event from the queue.  (Note that this function will
not get more events from the windowing system.  It only checks the events
that have already been moved to the GDK event queue.)</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>display</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</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 the first <a class="link" href="gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> on the 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 the queue. 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="id3054732"></a><h3>
<a name="gdk-display-put-event"></a>gdk_display_put_event ()</h3>
<a class="indexterm" name="id3054747"></a><pre class="programlisting">void                gdk_display_put_event               (<a class="link" href="GdkDisplay.html" title="GdkDisplay">GdkDisplay</a> *display,
                                                         <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 <em class="parameter"><code>display</code></em>.</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>display</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a>
</td>
</tr>
<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>
<p class="since">Since  2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3054847"></a><h3>
<a name="gdk-display-add-client-message-filter"></a>gdk_display_add_client_message_filter ()</h3>
<a class="indexterm" name="id3054863"></a><pre class="programlisting">void                gdk_display_add_client_message_filter
                                                        (<a class="link" href="GdkDisplay.html" title="GdkDisplay">GdkDisplay</a> *display,
                                                         <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,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data);</pre>
<p>
Adds a filter to be called when X ClientMessage events are received.
See <a class="link" href="gdk-Windows.html#gdk-window-add-filter"><code class="function">gdk_window_add_filter()</code></a> if you are interested in filtering other
types of events.</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>display</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> for which this message filter applies
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>message_type</code></em>&#160;:</span></p></td>
<td> the type of ClientMessage events to receive.
  This will be checked against the <em class="parameter"><code>message_type</code></em> field 
  of the XClientMessage event struct.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>func</code></em>&#160;:</span></p></td>
<td> the function to call to process the event.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td> user data to pass to <em class="parameter"><code>func</code></em>.
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3055024"></a><h3>
<a name="gdk-display-set-double-click-time"></a>gdk_display_set_double_click_time ()</h3>
<a class="indexterm" name="id3055040"></a><pre class="programlisting">void                gdk_display_set_double_click_time   (<a class="link" href="GdkDisplay.html" title="GdkDisplay">GdkDisplay</a> *display,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> msec);</pre>
<p>
Sets the double click time (two clicks within this time interval
count as a double click and result in a <a class="link" href="gdk-Events.html#GDK-2BUTTON-PRESS:CAPS"><span class="type">GDK_2BUTTON_PRESS</span></a> event).
Applications should <span class="emphasis"><em>not</em></span> set this, it is a global 
user-configured setting.</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>display</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a>
</td>
</tr>
<tr>