gdk-events.html

最新gtk中文资料集

</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td>user data set when the event handler was installed with
<a class="link" href="gdk-Events.html#gdk-event-handler-set"><code class="function">gdk_event_handler_set()</code></a>.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3231874"></a><h3>
<a name="gdk-event-send-client-message"></a>gdk_event_send_client_message ()</h3>
<a class="indexterm" name="id3231888"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gdk_event_send_client_message       (<a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event,
                                                         <a class="link" href="gdk-Event-Structures.html#GdkNativeWindow">GdkNativeWindow</a> winid);</pre>
<p>
Sends an X ClientMessage event to a given window (which must be
on the default <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a>.)
This could be used for communicating between different applications,
though the amount of data is limited to 20 bytes.</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> the <a class="link" href="gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> to send, which should be a <a class="link" href="gdk-Event-Structures.html#GdkEventClient"><span class="type">GdkEventClient</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>winid</code></em>&#160;:</span></p></td>
<td>  the window to send the X ClientMessage event to.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> non-zero on success.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3232001"></a><h3>
<a name="gdk-event-send-client-message-for-display"></a>gdk_event_send_client_message_for_display ()</h3>
<a class="indexterm" name="id3232018"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gdk_event_send_client_message_for_display
                                                        (<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);</pre>
<p>
On X11, sends an X ClientMessage event to a given window. On
Windows, sends a message registered with the name
GDK_WIN32_CLIENT_MESSAGE.
</p>
<p>
This could be used for communicating between different
applications, though the amount of data is limited to 20 bytes on
X11, and to just four bytes on Windows.</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> the <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> for the window where the message is to be sent.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>event</code></em>&#160;:</span></p></td>
<td> the <a class="link" href="gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> to send, which should be a <a class="link" href="gdk-Event-Structures.html#GdkEventClient"><span class="type">GdkEventClient</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>winid</code></em>&#160;:</span></p></td>
<td> the window to send the client message to.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> non-zero on success.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3232163"></a><h3>
<a name="gdk-event-send-clientmessage-toall"></a>gdk_event_send_clientmessage_toall ()</h3>
<a class="indexterm" name="id3232178"></a><pre class="programlisting">void                gdk_event_send_clientmessage_toall  (<a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event);</pre>
<p>
Sends an X ClientMessage event to all toplevel windows on the default
<a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a>.
</p>
<p>
Toplevel windows are determined by checking for the WM_STATE property, as
described in the Inter-Client Communication Conventions Manual (ICCCM).
If no windows are found with the WM_STATE property set, the message is sent
to all children of the root window.</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> the <a class="link" href="gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> to send, which should be a <a class="link" href="gdk-Event-Structures.html#GdkEventClient"><span class="type">GdkEventClient</span></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3232260"></a><h3>
<a name="gdk-add-client-message-filter"></a>gdk_add_client_message_filter ()</h3>
<a class="indexterm" name="id3232274"></a><pre class="programlisting">void                gdk_add_client_message_filter       (<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 the default display to be called when X ClientMessage events
are received. See <a class="link" href="GdkDisplay.html#gdk-display-add-client-message-filter"><code class="function">gdk_display_add_client_message_filter()</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>message_type</code></em>&#160;:</span></p></td>
<td> the type of ClientMessage events to receive. This will be
    checked against the <em class="structfield"><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>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3232393"></a><h3>
<a name="gdk-get-show-events"></a>gdk_get_show_events ()</h3>
<a class="indexterm" name="id3232407"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gdk_get_show_events                 (void);</pre>
<p>
Gets whether event debugging output is enabled.</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 event debugging output is enabled.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3232457"></a><h3>
<a name="gdk-set-show-events"></a>gdk_set_show_events ()</h3>
<a class="indexterm" name="id3232471"></a><pre class="programlisting">void                gdk_set_show_events                 (<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> show_events);</pre>
<p>
Sets whether a trace of received events is output.
Note that GTK+ must be compiled with debugging (that is,
configured using the <code class="option">--enable-debug</code> option)
to use this option.</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>show_events</code></em>&#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> to output event debugging information.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3232537"></a><h3>
<a name="gdk-event-set-screen"></a>gdk_event_set_screen ()</h3>
<a class="indexterm" name="id3232553"></a><pre class="programlisting">void                gdk_event_set_screen                (<a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event,
                                                         <a class="link" href="GdkScreen.html" title="GdkScreen">GdkScreen</a> *screen);</pre>
<p>
Sets the screen for <em class="parameter"><code>event</code></em> to <em class="parameter"><code>screen</code></em>. The event must
have been allocated by GTK+, for instance, by
<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>
<tr>
<td><p><span class="term"><em class="parameter"><code>screen</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3232670"></a><h3>
<a name="gdk-event-get-screen"></a>gdk_event_get_screen ()</h3>
<a class="indexterm" name="id3232685"></a><pre class="programlisting"><a class="link" href="GdkScreen.html" title="GdkScreen">GdkScreen</a>*          gdk_event_get_screen                (<a class="link" href="gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event);</pre>
<p>
Returns the screen for the event. The screen is
typically the screen for <code class="literal">event-&gt;any.window</code>, 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 <code class="literal">event-&gt;motion.x_root</code> and
<code class="literal">event-&gt;motion.y_root</code> are relative.</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> the screen for the event

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3232782"></a><h3>
<a name="gdk-setting-get"></a>gdk_setting_get ()</h3>
<a class="indexterm" name="id3232795"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gdk_setting_get                     (const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *name,