New upstream version 3.24.11

This commit is contained in:
Iain Lane
2019-09-04 16:25:11 +01:00
635 changed files with 96293 additions and 94473 deletions

View File

@ -8,7 +8,7 @@
<link rel="up" href="reference.html" title="API Reference">
<link rel="prev" href="GdkGLContext.html" title="GdkGLContext">
<link rel="next" href="gdk3-Event-Structures.html" title="Event Structures">
<meta name="generator" content="GTK-Doc V1.30.1 (XML mode)">
<meta name="generator" content="GTK-Doc V1.29 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@ -451,7 +451,7 @@
<p>This section describes functions dealing with events from the window
system.</p>
<p>In GTK+ applications the events are handled automatically in
<a href="https://developer.gnome.org/gtk4/gtk4-General.html#gtk-main-do-event"><code class="function">gtk_main_do_event()</code></a> and passed on to the appropriate widgets, so these
<code class="function">gtk_main_do_event()</code> and passed on to the appropriate widgets, so these
functions are rarely needed. Though some of the fields in the
<a class="link" href="gdk3-Event-Structures.html" title="Event Structures">Event Structures</a> are useful.</p>
</div>
@ -1152,13 +1152,13 @@ motion events from a <a class="link" href="gdk3-Events.html#GDK-MOTION-NOTIFY:CA
5
6
7</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="p">{</span>
<span class="c1">// motion_event handler</span>
<span class="n">x</span> <span class="o">=</span> <span class="n">motion_event</span><span class="o">-&gt;</span><span class="n">x</span><span class="p">;</span>
<span class="n">y</span> <span class="o">=</span> <span class="n">motion_event</span><span class="o">-&gt;</span><span class="n">y</span><span class="p">;</span>
<span class="c1">// handle (x,y) motion</span>
<span class="n">gdk_event_request_motions</span> <span class="p">(</span><span class="n">motion_event</span><span class="p">);</span> <span class="c1">// handles is_hint events</span>
<span class="p">}</span></pre></td>
<td class="listing_code"><pre class="programlisting"><span class="cbracket">{</span>
<span class="normal"> </span><span class="comment">// motion_event handler</span>
<span class="normal"> x </span><span class="symbol">=</span><span class="normal"> motion_event</span><span class="symbol">-&gt;</span><span class="normal">x</span><span class="symbol">;</span>
<span class="normal"> y </span><span class="symbol">=</span><span class="normal"> motion_event</span><span class="symbol">-&gt;</span><span class="normal">y</span><span class="symbol">;</span>
<span class="normal"> </span><span class="comment">// handle (x,y) motion</span>
<span class="normal"> </span><span class="function"><a href="gdk3-Events.html#gdk-event-request-motions">gdk_event_request_motions</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">motion_event</span><span class="symbol">);</span><span class="normal"> </span><span class="comment">// handles is_hint events</span>
<span class="cbracket">}</span></pre></td>
</tr>
</tbody>
</table>
@ -1438,7 +1438,7 @@ gdk_event_handler_set (<em class="parameter"><code><a class="link" href="gdk3-Ev
<p>Sets the function to call to handle all events from GDK.</p>
<p>Note that GTK+ uses this to install its own event handler, so it is
usually not useful for GTK+ applications. (Although an application
can call this function then call <a href="https://developer.gnome.org/gtk4/gtk4-General.html#gtk-main-do-event"><code class="function">gtk_main_do_event()</code></a> to pass
can call this function then call <code class="function">gtk_main_do_event()</code> to pass
events to GTK+.)</p>
<div class="refsect3">
<a name="gdk-event-handler-set.parameters"></a><h4>Parameters</h4>
@ -1877,8 +1877,8 @@ be used instead.</p>
<td class="enum_member_name"><p><a name="GDK-DELETE:CAPS"></a>GDK_DELETE</p></td>
<td class="enum_member_description">
<p>the window manager has requested that the toplevel window be
hidden or destroyed, usually when the user clicks on a special icon in the
title bar.</p>
hidden or destroyed, usually when the user clicks on a special icon in the
title bar.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
@ -1893,7 +1893,7 @@ title bar.</p>
<td class="enum_member_name"><p><a name="GDK-EXPOSE:CAPS"></a>GDK_EXPOSE</p></td>
<td class="enum_member_description">
<p>all or part of the window has become visible and needs to be
redrawn.</p>
redrawn.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
@ -1915,8 +1915,8 @@ redrawn.</p>
<td class="enum_member_name"><p><a name="GDK-2BUTTON-PRESS:CAPS"></a>GDK_2BUTTON_PRESS</p></td>
<td class="enum_member_description">
<p>a mouse button has been double-clicked (clicked twice
within a short period of time). Note that each click also generates a
<a class="link" href="gdk3-Events.html#GDK-BUTTON-PRESS:CAPS"><code class="literal">GDK_BUTTON_PRESS</code></a> event.</p>
within a short period of time). Note that each click also generates a
<a class="link" href="gdk3-Events.html#GDK-BUTTON-PRESS:CAPS"><code class="literal">GDK_BUTTON_PRESS</code></a> event.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
@ -1931,7 +1931,7 @@ within a short period of time). Note that each click also generates a
<td class="enum_member_name"><p><a name="GDK-3BUTTON-PRESS:CAPS"></a>GDK_3BUTTON_PRESS</p></td>
<td class="enum_member_description">
<p>a mouse button has been clicked 3 times in a short period
of time. Note that each click also generates a <a class="link" href="gdk3-Events.html#GDK-BUTTON-PRESS:CAPS"><code class="literal">GDK_BUTTON_PRESS</code></a> event.</p>
of time. Note that each click also generates a <a class="link" href="gdk3-Events.html#GDK-BUTTON-PRESS:CAPS"><code class="literal">GDK_BUTTON_PRESS</code></a> event.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
@ -1988,7 +1988,7 @@ of time. Note that each click also generates a <a class="link" href="gdk3-Events
<td class="enum_member_name"><p><a name="GDK-CONFIGURE:CAPS"></a>GDK_CONFIGURE</p></td>
<td class="enum_member_description">
<p>the size, position or stacking order of the window has changed.
Note that GTK+ discards these events for <a class="link" href="gdk3-Windows.html#GDK-WINDOW-CHILD:CAPS"><code class="literal">GDK_WINDOW_CHILD</code></a> windows.</p>
Note that GTK+ discards these events for <a class="link" href="gdk3-Windows.html#GDK-WINDOW-CHILD:CAPS"><code class="literal">GDK_WINDOW_CHILD</code></a> windows.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
@ -2038,7 +2038,7 @@ Note that GTK+ discards these events for <a class="link" href="gdk3-Windows.html
<td class="enum_member_name"><p><a name="GDK-PROXIMITY-IN:CAPS"></a>GDK_PROXIMITY_IN</p></td>
<td class="enum_member_description">
<p>an input device has moved into contact with a sensing
surface (e.g. a touchscreen or graphics tablet).</p>
surface (e.g. a touchscreen or graphics tablet).</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
@ -2046,7 +2046,7 @@ surface (e.g. a touchscreen or graphics tablet).</p>
<td class="enum_member_name"><p><a name="GDK-PROXIMITY-OUT:CAPS"></a>GDK_PROXIMITY_OUT</p></td>
<td class="enum_member_description">
<p>an input device has moved out of contact with a sensing
surface.</p>
surface.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
@ -2068,7 +2068,7 @@ surface.</p>
<td class="enum_member_name"><p><a name="GDK-DRAG-MOTION:CAPS"></a>GDK_DRAG_MOTION</p></td>
<td class="enum_member_description">
<p>the mouse has moved in the window while a drag is in
progress.</p>
progress.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
@ -2076,7 +2076,7 @@ progress.</p>
<td class="enum_member_name"><p><a name="GDK-DRAG-STATUS:CAPS"></a>GDK_DRAG_STATUS</p></td>
<td class="enum_member_description">
<p>the status of the drag operation initiated by the window
has changed.</p>
has changed.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
@ -2119,7 +2119,7 @@ has changed.</p>
<td class="enum_member_name"><p><a name="GDK-WINDOW-STATE:CAPS"></a>GDK_WINDOW_STATE</p></td>
<td class="enum_member_description">
<p>the state of a window has changed. See <a class="link" href="gdk3-Event-Structures.html#GdkWindowState" title="enum GdkWindowState"><span class="type">GdkWindowState</span></a>
for the possible window states</p>
for the possible window states</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
@ -2134,7 +2134,7 @@ for the possible window states</p>
<td class="enum_member_name"><p><a name="GDK-OWNER-CHANGE:CAPS"></a>GDK_OWNER_CHANGE</p></td>
<td class="enum_member_description">
<p>the owner of a selection has changed. This event type
was added in 2.6</p>
was added in 2.6</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
@ -2142,7 +2142,7 @@ was added in 2.6</p>
<td class="enum_member_name"><p><a name="GDK-GRAB-BROKEN:CAPS"></a>GDK_GRAB_BROKEN</p></td>
<td class="enum_member_description">
<p>a pointer or keyboard grab was broken. This event type
was added in 2.8.</p>
was added in 2.8.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
@ -2150,7 +2150,7 @@ was added in 2.8.</p>
<td class="enum_member_name"><p><a name="GDK-DAMAGE:CAPS"></a>GDK_DAMAGE</p></td>
<td class="enum_member_description">
<p>the content of the window has been changed. This event type
was added in 2.14.</p>
was added in 2.14.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
@ -2158,7 +2158,7 @@ was added in 2.14.</p>
<td class="enum_member_name"><p><a name="GDK-TOUCH-BEGIN:CAPS"></a>GDK_TOUCH_BEGIN</p></td>
<td class="enum_member_description">
<p>A new touch event sequence has just started. This event
type was added in 3.4.</p>
type was added in 3.4.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
@ -2166,7 +2166,7 @@ type was added in 3.4.</p>
<td class="enum_member_name"><p><a name="GDK-TOUCH-UPDATE:CAPS"></a>GDK_TOUCH_UPDATE</p></td>
<td class="enum_member_description">
<p>A touch event sequence has been updated. This event type
was added in 3.4.</p>
was added in 3.4.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
@ -2174,7 +2174,7 @@ was added in 3.4.</p>
<td class="enum_member_name"><p><a name="GDK-TOUCH-END:CAPS"></a>GDK_TOUCH_END</p></td>
<td class="enum_member_description">
<p>A touch event sequence has finished. This event type
was added in 3.4.</p>
was added in 3.4.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
@ -2182,7 +2182,7 @@ was added in 3.4.</p>
<td class="enum_member_name"><p><a name="GDK-TOUCH-CANCEL:CAPS"></a>GDK_TOUCH_CANCEL</p></td>
<td class="enum_member_description">
<p>A touch event sequence has been canceled. This event type
was added in 3.4.</p>
was added in 3.4.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
@ -2190,7 +2190,7 @@ was added in 3.4.</p>
<td class="enum_member_name"><p><a name="GDK-TOUCHPAD-SWIPE:CAPS"></a>GDK_TOUCHPAD_SWIPE</p></td>
<td class="enum_member_description">
<p>A touchpad swipe gesture event, the current state
is determined by its phase field. This event type was added in 3.18.</p>
is determined by its phase field. This event type was added in 3.18.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
@ -2198,7 +2198,7 @@ is determined by its phase field. This event type was added in 3.18.</p>
<td class="enum_member_name"><p><a name="GDK-TOUCHPAD-PINCH:CAPS"></a>GDK_TOUCHPAD_PINCH</p></td>
<td class="enum_member_description">
<p>A touchpad pinch gesture event, the current state
is determined by its phase field. This event type was added in 3.18.</p>
is determined by its phase field. This event type was added in 3.18.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
@ -2206,7 +2206,7 @@ is determined by its phase field. This event type was added in 3.18.</p>
<td class="enum_member_name"><p><a name="GDK-PAD-BUTTON-PRESS:CAPS"></a>GDK_PAD_BUTTON_PRESS</p></td>
<td class="enum_member_description">
<p>A tablet pad button press event. This event type
was added in 3.22.</p>
was added in 3.22.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
@ -2214,7 +2214,7 @@ was added in 3.22.</p>
<td class="enum_member_name"><p><a name="GDK-PAD-BUTTON-RELEASE:CAPS"></a>GDK_PAD_BUTTON_RELEASE</p></td>
<td class="enum_member_description">
<p>A tablet pad button release event. This event type
was added in 3.22.</p>
was added in 3.22.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
@ -2222,7 +2222,7 @@ was added in 3.22.</p>
<td class="enum_member_name"><p><a name="GDK-PAD-RING:CAPS"></a>GDK_PAD_RING</p></td>
<td class="enum_member_description">
<p>A tablet pad axis event from a "ring". This event type was
added in 3.22.</p>
added in 3.22.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
@ -2230,7 +2230,7 @@ added in 3.22.</p>
<td class="enum_member_name"><p><a name="GDK-PAD-STRIP:CAPS"></a>GDK_PAD_STRIP</p></td>
<td class="enum_member_description">
<p>A tablet pad axis event from a "strip". This event type was
added in 3.22.</p>
added in 3.22.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
@ -2238,7 +2238,7 @@ added in 3.22.</p>
<td class="enum_member_name"><p><a name="GDK-PAD-GROUP-MODE:CAPS"></a>GDK_PAD_GROUP_MODE</p></td>
<td class="enum_member_description">
<p>A tablet pad group mode change. This event type was
added in 3.22.</p>
added in 3.22.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
@ -2424,7 +2424,7 @@ events, so different sequences may be distinguished.</p>
<td class="enum_member_name"><p><a name="GDK-SUBSTRUCTURE-MASK:CAPS"></a>GDK_SUBSTRUCTURE_MASK</p></td>
<td class="enum_member_description">
<p>receive events about window configuration changes of
child windows</p>
child windows</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
@ -2553,6 +2553,6 @@ left button in a left-handed setup.</p>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.30.1</div>
<hr>Generated by GTK-Doc V1.29</div>
</body>
</html>