callisto-debian/gtk3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

New upstream version 3.24.7

Browse Source
This commit is contained in:
Iain Lane
2019-03-13 10:08:13 +00:00
parent ac00df30b2 d9a382d689
commit 1f6000bb1a
227 changed files with 701173 additions and 623140 deletions
Download Patch File Download Diff File Expand all files Collapse all files

150
docs/reference/gtk/html/GtkWidget.html
View File

@ -199,7 +199,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gdk3/GdkFrameClock.html#GdkFrameClock-struct"><span class="returnvalue">GdkFrameClock</span></a> *
<a href="https://developer.gnome.org/gdk4/GdkFrameClock.html#GdkFrameClock-struct"><span class="returnvalue">GdkFrameClock</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkWidget.html#gtk-widget-get-frame-clock" title="gtk_widget_get_frame_clock ()">gtk_widget_get_frame_clock</a> <span class="c_punctuation">()</span>
@ -454,7 +454,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GdkEventMask"><span class="returnvalue">GdkEventMask</span></a>
<a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GdkEventMask"><span class="returnvalue">GdkEventMask</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkWidget.html#gtk-widget-get-device-events" title="gtk_widget_get_device_events ()">gtk_widget_get_device_events</a> <span class="c_punctuation">()</span>
@ -1077,7 +1077,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gdk3/GdkDisplay.html#GdkDisplay-struct"><span class="returnvalue">GdkDisplay</span></a> *
<a href="https://developer.gnome.org/gdk4/GdkDisplay.html#GdkDisplay-struct"><span class="returnvalue">GdkDisplay</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkWidget.html#gtk-widget-get-display" title="gtk_widget_get_display ()">gtk_widget_get_display</a> <span class="c_punctuation">()</span>
@ -1677,7 +1677,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gdk3/gdk3-Windows.html#GdkModifierType"><span class="returnvalue">GdkModifierType</span></a>
<a href="https://developer.gnome.org/gdk4/GdkSurface.html#GdkModifierType"><span class="returnvalue">GdkModifierType</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkWidget.html#gtk-widget-get-modifier-mask" title="gtk_widget_get_modifier_mask ()">gtk_widget_get_modifier_mask</a> <span class="c_punctuation">()</span>
@ -2189,7 +2189,7 @@
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GdkEventMask"><span class="type">GdkEventMask</span></a></td>
<td class="property_type"><a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GdkEventMask"><span class="type">GdkEventMask</span></a></td>
<td class="property_name"><a class="link" href="GtkWidget.html#GtkWidget--events" title="The “events” property">events</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -4094,16 +4094,16 @@ reposition its contents.</p>
<hr>
<div class="refsect2">
<a name="gtk-widget-get-frame-clock"></a><h3>gtk_widget_get_frame_clock ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gdk3/GdkFrameClock.html#GdkFrameClock-struct"><span class="returnvalue">GdkFrameClock</span></a> *
<pre class="programlisting"><a href="https://developer.gnome.org/gdk4/GdkFrameClock.html#GdkFrameClock-struct"><span class="returnvalue">GdkFrameClock</span></a> *
gtk_widget_get_frame_clock (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>);</pre>
<p>Obtains the frame clock for a widget. The frame clock is a global
“ticker” that can be used to drive animations and repaints. The
most common reason to get the frame clock is to call
<a href="https://developer.gnome.org/gdk3/GdkFrameClock.html#gdk-frame-clock-get-frame-time"><code class="function">gdk_frame_clock_get_frame_time()</code></a>, in order to get a time to use for
<a href="https://developer.gnome.org/gdk4/GdkFrameClock.html#gdk-frame-clock-get-frame-time"><code class="function">gdk_frame_clock_get_frame_time()</code></a>, in order to get a time to use for
animating. For example you might record the start of the animation
with an initial value from <a href="https://developer.gnome.org/gdk3/GdkFrameClock.html#gdk-frame-clock-get-frame-time"><code class="function">gdk_frame_clock_get_frame_time()</code></a>, and
with an initial value from <a href="https://developer.gnome.org/gdk4/GdkFrameClock.html#gdk-frame-clock-get-frame-time"><code class="function">gdk_frame_clock_get_frame_time()</code></a>, and
then update the animation by calling
<a href="https://developer.gnome.org/gdk3/GdkFrameClock.html#gdk-frame-clock-get-frame-time"><code class="function">gdk_frame_clock_get_frame_time()</code></a> again during each repaint.</p>
<a href="https://developer.gnome.org/gdk4/GdkFrameClock.html#gdk-frame-clock-get-frame-time"><code class="function">gdk_frame_clock_get_frame_time()</code></a> again during each repaint.</p>
<p>gdk_frame_clock_request_phase() will result in a new frame on the
clock, but won’t necessarily repaint any widgets. To repaint a
widget, you have to use <a class="link" href="GtkWidget.html#gtk-widget-queue-draw" title="gtk_widget_queue_draw ()"><code class="function">gtk_widget_queue_draw()</code></a> which invalidates
@ -4131,7 +4131,7 @@ change the widget’s frame clock.</p>
</div>
<div class="refsect3">
<a name="gtk-widget-get-frame-clock.returns"></a><h4>Returns</h4>
<p>a <a href="https://developer.gnome.org/gdk3/GdkFrameClock.html#GdkFrameClock-struct"><span class="type">GdkFrameClock</span></a>,
<p>a <a href="https://developer.gnome.org/gdk4/GdkFrameClock.html#GdkFrameClock-struct"><span class="type">GdkFrameClock</span></a>,
or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if widget is unrealized. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
@ -4173,7 +4173,7 @@ high density outputs, it can be a higher value (typically 2).</p>
<a name="GtkTickCallback"></a><h3>GtkTickCallback ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<span class="c_punctuation">(</span>*GtkTickCallback<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/GdkFrameClock.html#GdkFrameClock-struct"><span class="type">GdkFrameClock</span></a> *frame_clock</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk4/GdkFrameClock.html#GdkFrameClock-struct"><span class="type">GdkFrameClock</span></a> *frame_clock</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
<p>Callback type for adding a function to update animations. See <a class="link" href="GtkWidget.html#gtk-widget-add-tick-callback" title="gtk_widget_add_tick_callback ()"><code class="function">gtk_widget_add_tick_callback()</code></a>.</p>
<div class="refsect3">
@ -4231,11 +4231,11 @@ then you will have to call <a class="link" href="GtkWidget.html#gtk-widget-queue
<a class="link" href="GtkWidget.html#gtk-widget-queue-draw-area" title="gtk_widget_queue_draw_area ()"><code class="function">gtk_widget_queue_draw_area()</code></a> yourself.</p>
<p>gdk_frame_clock_get_frame_time() should generally be used for timing
continuous animations and
<a href="https://developer.gnome.org/gdk3/gdk3-GdkFrameTimings.html#gdk-frame-timings-get-predicted-presentation-time"><code class="function">gdk_frame_timings_get_predicted_presentation_time()</code></a> if you are
<a href="https://developer.gnome.org/gdk4/gdk4-GdkFrameTimings.html#gdk-frame-timings-get-predicted-presentation-time"><code class="function">gdk_frame_timings_get_predicted_presentation_time()</code></a> if you are
trying to display isolated frames at particular times.</p>
<p>This is a more convenient alternative to connecting directly to the
<a href="https://developer.gnome.org/gdk3/GdkFrameClock.html#GdkFrameClock-update"><span class="type">“update”</span></a> signal of <a href="https://developer.gnome.org/gdk3/GdkFrameClock.html#GdkFrameClock-struct"><span class="type">GdkFrameClock</span></a>, since you don't
have to worry about when a <a href="https://developer.gnome.org/gdk3/GdkFrameClock.html#GdkFrameClock-struct"><span class="type">GdkFrameClock</span></a> is assigned to a widget.</p>
<a href="https://developer.gnome.org/gdk4/GdkFrameClock.html#GdkFrameClock-update"><span class="type">“update”</span></a> signal of <a href="https://developer.gnome.org/gdk4/GdkFrameClock.html#GdkFrameClock-struct"><span class="type">GdkFrameClock</span></a>, since you don't
have to worry about when a <a href="https://developer.gnome.org/gdk4/GdkFrameClock.html#GdkFrameClock-struct"><span class="type">GdkFrameClock</span></a> is assigned to a widget.</p>
<div class="refsect3">
<a name="gtk-widget-add-tick-callback.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -4503,7 +4503,7 @@ gtk_widget_add_accelerator (<em class="parameter"><code><a class="link" href="Gt
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *accel_signal</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> *accel_group</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> accel_key</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> accel_mods</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk4/GdkSurface.html#GdkModifierType"><span class="type">GdkModifierType</span></a> accel_mods</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelFlags" title="enum GtkAccelFlags"><span class="type">GtkAccelFlags</span></a> accel_flags</code></em>);</pre>
<p>Installs an accelerator for this <em class="parameter"><code>widget</code></em>
in <em class="parameter"><code>accel_group</code></em>
@ -4567,7 +4567,7 @@ user, use <a class="link" href="gtk3-Accelerator-Maps.html#gtk-accel-map-add-ent
gtk_widget_remove_accelerator (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> *accel_group</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> accel_key</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/gdk3-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> accel_mods</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/gdk4/GdkSurface.html#GdkModifierType"><span class="type">GdkModifierType</span></a> accel_mods</code></em>);</pre>
<p>Removes an accelerator from <em class="parameter"><code>widget</code></em>
, previously installed with
<a class="link" href="GtkWidget.html#gtk-widget-add-accelerator" title="gtk_widget_add_accelerator ()"><code class="function">gtk_widget_add_accelerator()</code></a>.</p>
@ -5239,7 +5239,7 @@ if it does not have a parent window. </p>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_widget_set_events (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> events</code></em>);</pre>
<p>Sets the event mask (see <a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GdkEventMask"><span class="type">GdkEventMask</span></a>) for a widget. The event
<p>Sets the event mask (see <a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GdkEventMask"><span class="type">GdkEventMask</span></a>) for a widget. The event
mask determines which events a widget will receive. Keep in mind
that different widgets have different default event masks, and by
changing the event mask you may disrupt a widget’s functionality,
@ -5278,7 +5278,7 @@ box.</p>
<a name="gtk-widget-get-events"></a><h3>gtk_widget_get_events ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
gtk_widget_get_events (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>);</pre>
<p>Returns the event mask (see <a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GdkEventMask"><span class="type">GdkEventMask</span></a>) for the widget. These are the
<p>Returns the event mask (see <a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GdkEventMask"><span class="type">GdkEventMask</span></a>) for the widget. These are the
events that the widget will receive.</p>
<p>Note: Internally, the widget event mask will be the logical OR of the event
mask set through <a class="link" href="GtkWidget.html#gtk-widget-set-events" title="gtk_widget_set_events ()"><code class="function">gtk_widget_set_events()</code></a> or <a class="link" href="GtkWidget.html#gtk-widget-add-events" title="gtk_widget_add_events ()"><code class="function">gtk_widget_add_events()</code></a>, and the
@ -5332,7 +5332,7 @@ gtk_widget_add_events (<em class="parameter"><code><a class="link" href="GtkWidg
</tr>
<tr>
<td class="parameter_name"><p>events</p></td>
<td class="parameter_description"><p>an event mask, see <a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GdkEventMask"><span class="type">GdkEventMask</span></a></p></td>
<td class="parameter_description"><p>an event mask, see <a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GdkEventMask"><span class="type">GdkEventMask</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -5344,9 +5344,9 @@ gtk_widget_add_events (<em class="parameter"><code><a class="link" href="GtkWidg
<a name="gtk-widget-set-device-events"></a><h3>gtk_widget_set_device_events ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_widget_set_device_events (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a> *device</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GdkEventMask"><span class="type">GdkEventMask</span></a> events</code></em>);</pre>
<p>Sets the device event mask (see <a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GdkEventMask"><span class="type">GdkEventMask</span></a>) for a widget. The event
<em class="parameter"><code><a href="https://developer.gnome.org/gdk4/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a> *device</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GdkEventMask"><span class="type">GdkEventMask</span></a> events</code></em>);</pre>
<p>Sets the device event mask (see <a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GdkEventMask"><span class="type">GdkEventMask</span></a>) for a widget. The event
mask determines which events a widget will receive from <em class="parameter"><code>device</code></em>
. Keep
in mind that different widgets have different default event masks, and by
@ -5374,7 +5374,7 @@ and receive events on the event box.</p>
</tr>
<tr>
<td class="parameter_name"><p>device</p></td>
<td class="parameter_description"><p>a <a href="https://developer.gnome.org/gdk3/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a></p></td>
<td class="parameter_description"><p>a <a href="https://developer.gnome.org/gdk4/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
@ -5390,9 +5390,9 @@ and receive events on the event box.</p>
<hr>
<div class="refsect2">
<a name="gtk-widget-get-device-events"></a><h3>gtk_widget_get_device_events ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GdkEventMask"><span class="returnvalue">GdkEventMask</span></a>
<pre class="programlisting"><a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GdkEventMask"><span class="returnvalue">GdkEventMask</span></a>
gtk_widget_get_device_events (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a> *device</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/gdk4/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a> *device</code></em>);</pre>
<p>Returns the events mask for the widget corresponding to an specific device. These
are the events that the widget will receive when <em class="parameter"><code>device</code></em>
operates on it.</p>
@ -5412,7 +5412,7 @@ are the events that the widget will receive when <em class="parameter"><code>dev
</tr>
<tr>
<td class="parameter_name"><p>device</p></td>
<td class="parameter_description"><p>a <a href="https://developer.gnome.org/gdk3/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a></p></td>
<td class="parameter_description"><p>a <a href="https://developer.gnome.org/gdk4/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -5430,8 +5430,8 @@ are the events that the widget will receive when <em class="parameter"><code>dev
<a name="gtk-widget-add-device-events"></a><h3>gtk_widget_add_device_events ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_widget_add_device_events (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a> *device</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GdkEventMask"><span class="type">GdkEventMask</span></a> events</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/gdk4/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a> *device</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GdkEventMask"><span class="type">GdkEventMask</span></a> events</code></em>);</pre>
<p>Adds the device events in the bitfield <em class="parameter"><code>events</code></em>
to the event mask for
<em class="parameter"><code>widget</code></em>
@ -5452,12 +5452,12 @@ gtk_widget_add_device_events (<em class="parameter"><code><a class="link" href="
</tr>
<tr>
<td class="parameter_name"><p>device</p></td>
<td class="parameter_description"><p>a <a href="https://developer.gnome.org/gdk3/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a></p></td>
<td class="parameter_description"><p>a <a href="https://developer.gnome.org/gdk4/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>events</p></td>
<td class="parameter_description"><p>an event mask, see <a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GdkEventMask"><span class="type">GdkEventMask</span></a></p></td>
<td class="parameter_description"><p>an event mask, see <a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GdkEventMask"><span class="type">GdkEventMask</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -5470,9 +5470,9 @@ gtk_widget_add_device_events (<em class="parameter"><code><a class="link" href="
<a name="gtk-widget-set-device-enabled"></a><h3>gtk_widget_set_device_enabled ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_widget_set_device_enabled (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a> *device</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk4/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a> *device</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> enabled</code></em>);</pre>
<p>Enables or disables a <a href="https://developer.gnome.org/gdk3/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a> to interact with <em class="parameter"><code>widget</code></em>
<p>Enables or disables a <a href="https://developer.gnome.org/gdk4/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a> to interact with <em class="parameter"><code>widget</code></em>
and all its children.</p>
<p>It does so by descending through the <a href="https://developer.gnome.org/gdk3/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> hierarchy
@ -5494,7 +5494,7 @@ and enabling the same mask that is has for core events
</tr>
<tr>
<td class="parameter_name"><p>device</p></td>
<td class="parameter_description"><p>a <a href="https://developer.gnome.org/gdk3/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a></p></td>
<td class="parameter_description"><p>a <a href="https://developer.gnome.org/gdk4/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
@ -5512,7 +5512,7 @@ and enabling the same mask that is has for core events
<a name="gtk-widget-get-device-enabled"></a><h3>gtk_widget_get_device_enabled ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gtk_widget_get_device_enabled (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a> *device</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/gdk4/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a> *device</code></em>);</pre>
<p>Returns whether <em class="parameter"><code>device</code></em>
can interact with <em class="parameter"><code>widget</code></em>
and its
@ -5533,7 +5533,7 @@ children. See <a class="link" href="GtkWidget.html#gtk-widget-set-device-enabled
</tr>
<tr>
<td class="parameter_name"><p>device</p></td>
<td class="parameter_description"><p>a <a href="https://developer.gnome.org/gdk3/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a></p></td>
<td class="parameter_description"><p>a <a href="https://developer.gnome.org/gdk4/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -8006,9 +8006,9 @@ window similar to the quick search in <a class="link" href="GtkTreeView.html" ti
9
10
11</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="usertype">GdkEvent</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">fevent </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="https://developer.gnome.org/gdk3/gdk3-Events.html#gdk-event-new">gdk_event_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GDK-FOCUS-CHANGE:CAPS">GDK_FOCUS_CHANGE</a></span><span class="symbol">);</span>
<td class="listing_code"><pre class="programlisting"><span class="usertype">GdkEvent</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">fevent </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="https://developer.gnome.org/gdk4/gdk4-Events.html#gdk-event-new">gdk_event_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GDK-FOCUS-CHANGE:CAPS">GDK_FOCUS_CHANGE</a></span><span class="symbol">);</span>
<span class="normal">fevent</span><span class="symbol">-&gt;</span><span class="normal">focus_change</span><span class="symbol">.</span><span class="normal">type </span><span class="symbol">=</span><span class="normal"> <a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GDK-FOCUS-CHANGE:CAPS">GDK_FOCUS_CHANGE</a></span><span class="symbol">;</span>
<span class="normal">fevent</span><span class="symbol">-&gt;</span><span class="normal">focus_change</span><span class="symbol">.</span><span class="normal">type </span><span class="symbol">=</span><span class="normal"> <a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GDK-FOCUS-CHANGE:CAPS">GDK_FOCUS_CHANGE</a></span><span class="symbol">;</span>
<span class="normal">fevent</span><span class="symbol">-&gt;</span><span class="normal">focus_change</span><span class="symbol">.</span><span class="normal">in </span><span class="symbol">=</span><span class="normal"> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS">TRUE</a></span><span class="symbol">;</span>
<span class="normal">fevent</span><span class="symbol">-&gt;</span><span class="normal">focus_change</span><span class="symbol">.</span><span class="normal">window </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkWidget.html#gtk-widget-get-window">_gtk_widget_get_window</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">);</span>
<span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">fevent</span><span class="symbol">-&gt;</span><span class="normal">focus_change</span><span class="symbol">.</span><span class="normal">window </span><span class="symbol">!=</span><span class="normal"> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">)</span>
@ -8545,11 +8545,11 @@ to a particular <a href="https://developer.gnome.org/gdk3/GdkScreen.html#GdkScre
<a name="gtk-widget-get-clipboard"></a><h3>gtk_widget_get_clipboard ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-Clipboards.html#GtkClipboard"><span class="returnvalue">GtkClipboard</span></a> *
gtk_widget_get_clipboard (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/gdk4/gdk4-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> selection</code></em>);</pre>
<p>Returns the clipboard object for the given selection to
be used with <em class="parameter"><code>widget</code></em>
. <em class="parameter"><code>widget</code></em>
must have a <a href="https://developer.gnome.org/gdk3/GdkDisplay.html#GdkDisplay-struct"><span class="type">GdkDisplay</span></a>
must have a <a href="https://developer.gnome.org/gdk4/GdkDisplay.html#GdkDisplay-struct"><span class="type">GdkDisplay</span></a>
associated with it, so must be attached to a toplevel
window.</p>
<div class="refsect3">
@ -8568,7 +8568,7 @@ window.</p>
</tr>
<tr>
<td class="parameter_name"><p>selection</p></td>
<td class="parameter_description"><p>a <a href="https://developer.gnome.org/gdk3/gdk3-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> which identifies the clipboard
<td class="parameter_description"><p>a <a href="https://developer.gnome.org/gdk4/gdk4-Properties-and-Atoms.html#GdkAtom"><span class="type">GdkAtom</span></a> which identifies the clipboard
to use. <a href="https://developer.gnome.org/gdk3/gdk3-Selections.html#GDK-SELECTION-CLIPBOARD:CAPS"><code class="literal">GDK_SELECTION_CLIPBOARD</code></a> gives the
default clipboard. Another common value
is <a href="https://developer.gnome.org/gdk3/gdk3-Selections.html#GDK-SELECTION-PRIMARY:CAPS"><code class="literal">GDK_SELECTION_PRIMARY</code></a>, which gives
@ -8591,9 +8591,9 @@ been created, it is persistent for all time. </p>
<hr>
<div class="refsect2">
<a name="gtk-widget-get-display"></a><h3>gtk_widget_get_display ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gdk3/GdkDisplay.html#GdkDisplay-struct"><span class="returnvalue">GdkDisplay</span></a> *
<pre class="programlisting"><a href="https://developer.gnome.org/gdk4/GdkDisplay.html#GdkDisplay-struct"><span class="returnvalue">GdkDisplay</span></a> *
gtk_widget_get_display (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>);</pre>
<p>Get the <a href="https://developer.gnome.org/gdk3/GdkDisplay.html#GdkDisplay-struct"><span class="type">GdkDisplay</span></a> for the toplevel window associated with
<p>Get the <a href="https://developer.gnome.org/gdk4/GdkDisplay.html#GdkDisplay-struct"><span class="type">GdkDisplay</span></a> for the toplevel window associated with
this widget. This function can only be called after the widget
has been added to a widget hierarchy with a <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> at the top.</p>
<p>In general, you should only create display specific
@ -8616,7 +8616,7 @@ free those resources when the widget is unrealized.</p>
</div>
<div class="refsect3">
<a name="gtk-widget-get-display.returns"></a><h4>Returns</h4>
<p>the <a href="https://developer.gnome.org/gdk3/GdkDisplay.html#GdkDisplay-struct"><span class="type">GdkDisplay</span></a> for the toplevel for this widget. </p>
<p>the <a href="https://developer.gnome.org/gdk4/GdkDisplay.html#GdkDisplay-struct"><span class="type">GdkDisplay</span></a> for the toplevel for this widget. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.2</p>
@ -11177,7 +11177,7 @@ changed after some internal state change (so that they can call
<a name="gtk-widget-device-is-shadowed"></a><h3>gtk_widget_device_is_shadowed ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gtk_widget_device_is_shadowed (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a> *device</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/gdk4/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a> *device</code></em>);</pre>
<p>Returns <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>device</code></em>
has been shadowed by a GTK+
device grab on another widget, so it would stop sending
@ -11201,7 +11201,7 @@ devices. See <a class="link" href="gtk3-General.html#gtk-device-grab-add" title=
</tr>
<tr>
<td class="parameter_name"><p>device</p></td>
<td class="parameter_description"><p>a <a href="https://developer.gnome.org/gdk3/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a></p></td>
<td class="parameter_description"><p>a <a href="https://developer.gnome.org/gdk4/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -11218,13 +11218,13 @@ by another <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="
<hr>
<div class="refsect2">
<a name="gtk-widget-get-modifier-mask"></a><h3>gtk_widget_get_modifier_mask ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gdk3/gdk3-Windows.html#GdkModifierType"><span class="returnvalue">GdkModifierType</span></a>
<pre class="programlisting"><a href="https://developer.gnome.org/gdk4/GdkSurface.html#GdkModifierType"><span class="returnvalue">GdkModifierType</span></a>
gtk_widget_get_modifier_mask (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gdk3/gdk3-Windows.html#GdkModifierIntent"><span class="type">GdkModifierIntent</span></a> intent</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/gdk4/GdkSurface.html#GdkModifierIntent"><span class="type">GdkModifierIntent</span></a> intent</code></em>);</pre>
<p>Returns the modifier mask the <em class="parameter"><code>widget</code></em>
’s windowing system backend
uses for a particular purpose.</p>
<p>See <a href="https://developer.gnome.org/gdk3/gdk3-Keyboard-Handling.html#gdk-keymap-get-modifier-mask"><code class="function">gdk_keymap_get_modifier_mask()</code></a>.</p>
<p>See <a href="https://developer.gnome.org/gdk4/gdk4-Keyboard-Handling.html#gdk-keymap-get-modifier-mask"><code class="function">gdk_keymap_get_modifier_mask()</code></a>.</p>
<div class="refsect3">
<a name="gtk-widget-get-modifier-mask.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -14110,7 +14110,7 @@ site requests the data which is dragged.</p></td>
<tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkWidgetClass.drag-data-delete"></a>drag_data_delete</code></em> ()</p></td>
<td class="struct_member_description"><p>Signal emitted on the drag source when a drag
with the action <a href="https://developer.gnome.org/gdk3/gdk3-Drag-and-Drop.html#GDK-ACTION-MOVE:CAPS"><code class="literal">GDK_ACTION_MOVE</code></a> is successfully completed.</p></td>
with the action <a href="https://developer.gnome.org/gdk4/gdk4-Drag-and-Drop.html#GDK-ACTION-MOVE:CAPS"><code class="literal">GDK_ACTION_MOVE</code></a> is successfully completed.</p></td>
<td class="struct_member_annotations"> </td>
</tr>
<tr>
@ -14661,7 +14661,7 @@ a child or a container it is treated as <em class="parameter"><code>GTK_ALIGN_FI
<hr>
<div class="refsect2">
<a name="GtkWidget--events"></a><h3>The <code class="literal">“events”</code> property</h3>
<pre class="programlisting"> “events” <a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GdkEventMask"><span class="type">GdkEventMask</span></a></pre>
<pre class="programlisting"> “events” <a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GdkEventMask"><span class="type">GdkEventMask</span></a></pre>
<p>The event mask that decides what kind of GdkEvents this widget gets.</p>
<p>Flags: Read / Write</p>
<p>Default value: GDK_STRUCTURE_MASK</p>
@ -15274,7 +15274,7 @@ user_function (<a class="link" href="GtkWidget.html" title="GtkWidget"><span cla
<p>The ::button-press-event signal will be emitted when a button
(typically from a mouse) is pressed.</p>
<p>To receive this signal, the <a href="https://developer.gnome.org/gdk3/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> associated to the
widget needs to enable the <a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GDK-BUTTON-PRESS-MASK:CAPS"><span class="type">GDK_BUTTON_PRESS_MASK</span></a> mask.</p>
widget needs to enable the <a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GDK-BUTTON-PRESS-MASK:CAPS"><span class="type">GDK_BUTTON_PRESS_MASK</span></a> mask.</p>
<p>This signal will be sent to the grab widget if there is one.</p>
<div class="refsect3">
<a name="GtkWidget-button-press-event.parameters"></a><h4>Parameters</h4>
@ -15321,7 +15321,7 @@ user_function (<a class="link" href="GtkWidget.html" title="GtkWidget"><span cla
<p>The ::button-release-event signal will be emitted when a button
(typically from a mouse) is released.</p>
<p>To receive this signal, the <a href="https://developer.gnome.org/gdk3/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> associated to the
widget needs to enable the <a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GDK-BUTTON-RELEASE-MASK:CAPS"><span class="type">GDK_BUTTON_RELEASE_MASK</span></a> mask.</p>
widget needs to enable the <a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GDK-BUTTON-RELEASE-MASK:CAPS"><span class="type">GDK_BUTTON_RELEASE_MASK</span></a> mask.</p>
<p>This signal will be sent to the grab widget if there is one.</p>
<div class="refsect3">
<a name="GtkWidget-button-release-event.parameters"></a><h4>Parameters</h4>
@ -15493,7 +15493,7 @@ user_function (<a class="link" href="GtkWidget.html" title="GtkWidget"><span cla
stacking of the <em class="parameter"><code>widget</code></em>
's window has changed.</p>
<p>To receive this signal, the <a href="https://developer.gnome.org/gdk3/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> associated to the widget needs
to enable the <a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GDK-STRUCTURE-MASK:CAPS"><span class="type">GDK_STRUCTURE_MASK</span></a> mask. GDK will enable this mask
to enable the <a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GDK-STRUCTURE-MASK:CAPS"><span class="type">GDK_STRUCTURE_MASK</span></a> mask. GDK will enable this mask
automatically for all new windows.</p>
<div class="refsect3">
<a name="GtkWidget-configure-event.parameters"></a><h4>Parameters</h4>
@ -15668,7 +15668,7 @@ You rarely get this signal, because most widgets disconnect themselves
from their window before they destroy it, so no widget owns the
window at destroy time.</p>
<p>To receive this signal, the <a href="https://developer.gnome.org/gdk3/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> associated to the widget needs
to enable the <a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GDK-STRUCTURE-MASK:CAPS"><span class="type">GDK_STRUCTURE_MASK</span></a> mask. GDK will enable this mask
to enable the <a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GDK-STRUCTURE-MASK:CAPS"><span class="type">GDK_STRUCTURE_MASK</span></a> mask. GDK will enable this mask
automatically for all new windows.</p>
<div class="refsect3">
<a name="GtkWidget-destroy-event.parameters"></a><h4>Parameters</h4>
@ -15793,7 +15793,7 @@ user_function (<a class="link" href="GtkWidget.html" title="GtkWidget"><span cla
<a href="https://developer.gnome.org/gdk3/gdk3-Drag-and-Drop.html#GdkDragContext-struct"><span class="type">GdkDragContext</span></a> *context,
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<p>The ::drag-data-delete signal is emitted on the drag source when a drag
with the action <a href="https://developer.gnome.org/gdk3/gdk3-Drag-and-Drop.html#GDK-ACTION-MOVE:CAPS"><code class="literal">GDK_ACTION_MOVE</code></a> is successfully completed. The signal
with the action <a href="https://developer.gnome.org/gdk4/gdk4-Drag-and-Drop.html#GDK-ACTION-MOVE:CAPS"><code class="literal">GDK_ACTION_MOVE</code></a> is successfully completed. The signal
handler is responsible for deleting the data that has been dropped. What
"delete" means depends on the context of the drag operation.</p>
<div class="refsect3">
@ -15914,7 +15914,7 @@ whether the data was processed successfully.</p>
and therefore whether to call <a href="https://developer.gnome.org/gdk3/gdk3-Drag-and-Drop.html#gdk-drag-status"><code class="function">gdk_drag_status()</code></a> or <a class="link" href="gtk3-Drag-and-Drop.html#gtk-drag-finish" title="gtk_drag_finish ()"><code class="function">gtk_drag_finish()</code></a>. </p>
<p>The handler may inspect the selected action with
<a href="https://developer.gnome.org/gdk3/gdk3-Drag-and-Drop.html#gdk-drag-context-get-selected-action"><code class="function">gdk_drag_context_get_selected_action()</code></a> before calling
<a class="link" href="gtk3-Drag-and-Drop.html#gtk-drag-finish" title="gtk_drag_finish ()"><code class="function">gtk_drag_finish()</code></a>, e.g. to implement <a href="https://developer.gnome.org/gdk3/gdk3-Drag-and-Drop.html#GDK-ACTION-ASK:CAPS"><code class="literal">GDK_ACTION_ASK</code></a> as
<a class="link" href="gtk3-Drag-and-Drop.html#gtk-drag-finish" title="gtk_drag_finish ()"><code class="function">gtk_drag_finish()</code></a>, e.g. to implement <a href="https://developer.gnome.org/gdk4/gdk4-Drag-and-Drop.html#GDK-ACTION-ASK:CAPS"><code class="literal">GDK_ACTION_ASK</code></a> as
shown in the following example:</p>
<div class="informalexample">
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
@ -15977,7 +15977,7 @@ shown in the following example:</p>
<span class="normal"> </span><span class="comment">// handle data here</span>
<span class="normal"> action </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="https://developer.gnome.org/gdk3/gdk3-Drag-and-Drop.html#gdk-drag-context-get-selected-action">gdk_drag_context_get_selected_action</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">context</span><span class="symbol">);</span>
<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">action </span><span class="symbol">==</span><span class="normal"> <a href="https://developer.gnome.org/gdk3/gdk3-Drag-and-Drop.html#GDK-ACTION-ASK:CAPS">GDK_ACTION_ASK</a></span><span class="symbol">)</span>
<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">action </span><span class="symbol">==</span><span class="normal"> <a href="https://developer.gnome.org/gdk4/gdk4-Drag-and-Drop.html#GDK-ACTION-ASK:CAPS">GDK_ACTION_ASK</a></span><span class="symbol">)</span>
<span class="normal"> </span><span class="cbracket">{</span>
<span class="normal"> </span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">dialog</span><span class="symbol">;</span>
<span class="normal"> </span><span class="usertype">gint</span><span class="normal"> response</span><span class="symbol">;</span>
@ -15992,12 +15992,12 @@ shown in the following example:</p>
<span class="normal"> </span><span class="function"><a href="GtkWidget.html#gtk-widget-destroy">gtk_widget_destroy</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">dialog</span><span class="symbol">);</span>
<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">response </span><span class="symbol">==</span><span class="normal"> <a href="GtkDialog.html#GTK-RESPONSE-YES:CAPS">GTK_RESPONSE_YES</a></span><span class="symbol">)</span>
<span class="normal"> action </span><span class="symbol">=</span><span class="normal"> <a href="https://developer.gnome.org/gdk3/gdk3-Drag-and-Drop.html#GDK-ACTION-MOVE:CAPS">GDK_ACTION_MOVE</a></span><span class="symbol">;</span>
<span class="normal"> action </span><span class="symbol">=</span><span class="normal"> <a href="https://developer.gnome.org/gdk4/gdk4-Drag-and-Drop.html#GDK-ACTION-MOVE:CAPS">GDK_ACTION_MOVE</a></span><span class="symbol">;</span>
<span class="normal"> </span><span class="keyword">else</span>
<span class="normal"> action </span><span class="symbol">=</span><span class="normal"> <a href="https://developer.gnome.org/gdk3/gdk3-Drag-and-Drop.html#GDK-ACTION-COPY:CAPS">GDK_ACTION_COPY</a></span><span class="symbol">;</span>
<span class="normal"> action </span><span class="symbol">=</span><span class="normal"> <a href="https://developer.gnome.org/gdk4/gdk4-Drag-and-Drop.html#GDK-ACTION-COPY:CAPS">GDK_ACTION_COPY</a></span><span class="symbol">;</span>
<span class="normal"> </span><span class="cbracket">}</span>
<span class="normal"> </span><span class="function"><a href="gtk3-Drag-and-Drop.html#gtk-drag-finish">gtk_drag_finish</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">context</span><span class="symbol">,</span><span class="normal"> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS">TRUE</a></span><span class="symbol">,</span><span class="normal"> action </span><span class="symbol">==</span><span class="normal"> <a href="https://developer.gnome.org/gdk3/gdk3-Drag-and-Drop.html#GDK-ACTION-MOVE:CAPS">GDK_ACTION_MOVE</a></span><span class="symbol">,</span><span class="normal"> time</span><span class="symbol">);</span>
<span class="normal"> </span><span class="function"><a href="gtk3-Drag-and-Drop.html#gtk-drag-finish">gtk_drag_finish</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">context</span><span class="symbol">,</span><span class="normal"> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS">TRUE</a></span><span class="symbol">,</span><span class="normal"> action </span><span class="symbol">==</span><span class="normal"> <a href="https://developer.gnome.org/gdk4/gdk4-Drag-and-Drop.html#GDK-ACTION-MOVE:CAPS">GDK_ACTION_MOVE</a></span><span class="symbol">,</span><span class="normal"> time</span><span class="symbol">);</span>
<span class="normal"> </span><span class="cbracket">}</span>
<span class="normal"> </span><span class="keyword">else</span>
<span class="normal"> </span><span class="function"><a href="gtk3-Drag-and-Drop.html#gtk-drag-finish">gtk_drag_finish</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">context</span><span class="symbol">,</span><span class="normal"> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">,</span><span class="normal"> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">,</span><span class="normal"> time</span><span class="symbol">);</span>
@ -16508,7 +16508,7 @@ before and <a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-resto
with a clip region already set to the
widget's dirty region, i.e. to the area that needs repainting. Complicated
widgets that want to avoid redrawing themselves completely can get the full
extents of the clip region with <a href="https://developer.gnome.org/gdk3/gdk3-Cairo-Interaction.html#gdk-cairo-get-clip-rectangle"><code class="function">gdk_cairo_get_clip_rectangle()</code></a>, or they can
extents of the clip region with <a href="https://developer.gnome.org/gdk4/gdk4-Cairo-Interaction.html#gdk-cairo-get-clip-rectangle"><code class="function">gdk_cairo_get_clip_rectangle()</code></a>, or they can
get a finer-grained representation of the dirty region with
<a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-t.html#cairo-copy-clip-rectangle-list"><code class="function">cairo_copy_clip_rectangle_list()</code></a>.</p>
<div class="refsect3">
@ -16557,7 +16557,7 @@ user_function (<a class="link" href="GtkWidget.html" title="GtkWidget"><span cla
the <em class="parameter"><code>widget</code></em>
's window.</p>
<p>To receive this signal, the <a href="https://developer.gnome.org/gdk3/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> associated to the widget needs
to enable the <a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GDK-ENTER-NOTIFY-MASK:CAPS"><span class="type">GDK_ENTER_NOTIFY_MASK</span></a> mask.</p>
to enable the <a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GDK-ENTER-NOTIFY-MASK:CAPS"><span class="type">GDK_ENTER_NOTIFY_MASK</span></a> mask.</p>
<p>This signal will be sent to the grab widget if there is one.</p>
<div class="refsect3">
<a name="GtkWidget-enter-notify-event.parameters"></a><h4>Parameters</h4>
@ -16727,7 +16727,7 @@ user_function (<a class="link" href="GtkWidget.html" title="GtkWidget"><span cla
enters the <em class="parameter"><code>widget</code></em>
's window.</p>
<p>To receive this signal, the <a href="https://developer.gnome.org/gdk3/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> associated to the widget needs
to enable the <a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GDK-FOCUS-CHANGE-MASK:CAPS"><span class="type">GDK_FOCUS_CHANGE_MASK</span></a> mask.</p>
to enable the <a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GDK-FOCUS-CHANGE-MASK:CAPS"><span class="type">GDK_FOCUS_CHANGE_MASK</span></a> mask.</p>
<div class="refsect3">
<a name="GtkWidget-focus-in-event.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -16774,7 +16774,7 @@ user_function (<a class="link" href="GtkWidget.html" title="GtkWidget"><span cla
leaves the <em class="parameter"><code>widget</code></em>
's window.</p>
<p>To receive this signal, the <a href="https://developer.gnome.org/gdk3/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> associated to the widget needs
to enable the <a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GDK-FOCUS-CHANGE-MASK:CAPS"><span class="type">GDK_FOCUS_CHANGE_MASK</span></a> mask.</p>
to enable the <a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GDK-FOCUS-CHANGE-MASK:CAPS"><span class="type">GDK_FOCUS_CHANGE_MASK</span></a> mask.</p>
<div class="refsect3">
<a name="GtkWidget-focus-out-event.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -17017,7 +17017,7 @@ user_function (<a class="link" href="GtkWidget.html" title="GtkWidget"><span cla
<p>The ::key-press-event signal is emitted when a key is pressed. The signal
emission will reoccur at the key-repeat rate when the key is kept pressed.</p>
<p>To receive this signal, the <a href="https://developer.gnome.org/gdk3/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> associated to the widget needs
to enable the <a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GDK-KEY-PRESS-MASK:CAPS"><span class="type">GDK_KEY_PRESS_MASK</span></a> mask.</p>
to enable the <a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GDK-KEY-PRESS-MASK:CAPS"><span class="type">GDK_KEY_PRESS_MASK</span></a> mask.</p>
<p>This signal will be sent to the grab widget if there is one.</p>
<div class="refsect3">
<a name="GtkWidget-key-press-event.parameters"></a><h4>Parameters</h4>
@ -17062,7 +17062,7 @@ user_function (<a class="link" href="GtkWidget.html" title="GtkWidget"><span cla
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<p>The ::key-release-event signal is emitted when a key is released.</p>
<p>To receive this signal, the <a href="https://developer.gnome.org/gdk3/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> associated to the widget needs
to enable the <a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GDK-KEY-RELEASE-MASK:CAPS"><span class="type">GDK_KEY_RELEASE_MASK</span></a> mask.</p>
to enable the <a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GDK-KEY-RELEASE-MASK:CAPS"><span class="type">GDK_KEY_RELEASE_MASK</span></a> mask.</p>
<p>This signal will be sent to the grab widget if there is one.</p>
<div class="refsect3">
<a name="GtkWidget-key-release-event.parameters"></a><h4>Parameters</h4>
@ -17154,7 +17154,7 @@ user_function (<a class="link" href="GtkWidget.html" title="GtkWidget"><span cla
the <em class="parameter"><code>widget</code></em>
's window.</p>
<p>To receive this signal, the <a href="https://developer.gnome.org/gdk3/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> associated to the widget needs
to enable the <a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GDK-LEAVE-NOTIFY-MASK:CAPS"><span class="type">GDK_LEAVE_NOTIFY_MASK</span></a> mask.</p>
to enable the <a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GDK-LEAVE-NOTIFY-MASK:CAPS"><span class="type">GDK_LEAVE_NOTIFY_MASK</span></a> mask.</p>
<p>This signal will be sent to the grab widget if there is one.</p>
<div class="refsect3">
<a name="GtkWidget-leave-notify-event.parameters"></a><h4>Parameters</h4>
@ -17241,7 +17241,7 @@ user_function (<a class="link" href="GtkWidget.html" title="GtkWidget"><span cla
's window is
mapped. A window is mapped when it becomes visible on the screen.</p>
<p>To receive this signal, the <a href="https://developer.gnome.org/gdk3/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> associated to the widget needs
to enable the <a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GDK-STRUCTURE-MASK:CAPS"><span class="type">GDK_STRUCTURE_MASK</span></a> mask. GDK will enable this mask
to enable the <a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GDK-STRUCTURE-MASK:CAPS"><span class="type">GDK_STRUCTURE_MASK</span></a> mask. GDK will enable this mask
automatically for all new windows.</p>
<div class="refsect3">
<a name="GtkWidget-map-event.parameters"></a><h4>Parameters</h4>
@ -17334,7 +17334,7 @@ user_function (<a class="link" href="GtkWidget.html" title="GtkWidget"><span cla
<p>The ::motion-notify-event signal is emitted when the pointer moves
over the widget's <a href="https://developer.gnome.org/gdk3/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a>.</p>
<p>To receive this signal, the <a href="https://developer.gnome.org/gdk3/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> associated to the widget
needs to enable the <a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GDK-POINTER-MOTION-MASK:CAPS"><span class="type">GDK_POINTER_MOTION_MASK</span></a> mask.</p>
needs to enable the <a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GDK-POINTER-MOTION-MASK:CAPS"><span class="type">GDK_POINTER_MOTION_MASK</span></a> mask.</p>
<p>This signal will be sent to the grab widget if there is one.</p>
<div class="refsect3">
<a name="GtkWidget-motion-notify-event.parameters"></a><h4>Parameters</h4>
@ -17493,7 +17493,7 @@ user_function (<a class="link" href="GtkWidget.html" title="GtkWidget"><span cla
the <em class="parameter"><code>widget</code></em>
's window has been changed or deleted.</p>
<p>To receive this signal, the <a href="https://developer.gnome.org/gdk3/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> associated to the widget needs
to enable the <a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GDK-PROPERTY-CHANGE-MASK:CAPS"><span class="type">GDK_PROPERTY_CHANGE_MASK</span></a> mask.</p>
to enable the <a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GDK-PROPERTY-CHANGE-MASK:CAPS"><span class="type">GDK_PROPERTY_CHANGE_MASK</span></a> mask.</p>
<div class="refsect3">
<a name="GtkWidget-property-notify-event.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -17537,7 +17537,7 @@ user_function (<a class="link" href="GtkWidget.html" title="GtkWidget"><span cla
<a href="https://developer.gnome.org/gdk3/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event,
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<p>To receive this signal the <a href="https://developer.gnome.org/gdk3/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> associated to the widget needs
to enable the <a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GDK-PROXIMITY-IN-MASK:CAPS"><span class="type">GDK_PROXIMITY_IN_MASK</span></a> mask.</p>
to enable the <a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GDK-PROXIMITY-IN-MASK:CAPS"><span class="type">GDK_PROXIMITY_IN_MASK</span></a> mask.</p>
<p>This signal will be sent to the grab widget if there is one.</p>
<div class="refsect3">
<a name="GtkWidget-proximity-in-event.parameters"></a><h4>Parameters</h4>
@ -17582,7 +17582,7 @@ user_function (<a class="link" href="GtkWidget.html" title="GtkWidget"><span cla
<a href="https://developer.gnome.org/gdk3/gdk3-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event,
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<p>To receive this signal the <a href="https://developer.gnome.org/gdk3/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> associated to the widget needs
to enable the <a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GDK-PROXIMITY-OUT-MASK:CAPS"><span class="type">GDK_PROXIMITY_OUT_MASK</span></a> mask.</p>
to enable the <a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GDK-PROXIMITY-OUT-MASK:CAPS"><span class="type">GDK_PROXIMITY_OUT_MASK</span></a> mask.</p>
<p>This signal will be sent to the grab widget if there is one.</p>
<div class="refsect3">
<a name="GtkWidget-proximity-out-event.parameters"></a><h4>Parameters</h4>
@ -17784,7 +17784,7 @@ user_function (<a class="link" href="GtkWidget.html" title="GtkWidget"><span cla
range is pressed. Wheel mice are usually configured to generate
button press events for buttons 4 and 5 when the wheel is turned.</p>
<p>To receive this signal, the <a href="https://developer.gnome.org/gdk3/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> associated to the widget needs
to enable the <a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GDK-SCROLL-MASK:CAPS"><span class="type">GDK_SCROLL_MASK</span></a> mask.</p>
to enable the <a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GDK-SCROLL-MASK:CAPS"><span class="type">GDK_SCROLL_MASK</span></a> mask.</p>
<p>This signal will be sent to the grab widget if there is one.</p>
<div class="refsect3">
<a name="GtkWidget-scroll-event.parameters"></a><h4>Parameters</h4>
@ -18344,7 +18344,7 @@ user_function (<a class="link" href="GtkWidget.html" title="GtkWidget"><span cla
's window is
unmapped. A window is unmapped when it becomes invisible on the screen.</p>
<p>To receive this signal, the <a href="https://developer.gnome.org/gdk3/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> associated to the widget needs
to enable the <a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GDK-STRUCTURE-MASK:CAPS"><span class="type">GDK_STRUCTURE_MASK</span></a> mask. GDK will enable this mask
to enable the <a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GDK-STRUCTURE-MASK:CAPS"><span class="type">GDK_STRUCTURE_MASK</span></a> mask. GDK will enable this mask
automatically for all new windows.</p>
<div class="refsect3">
<a name="GtkWidget-unmap-event.parameters"></a><h4>Parameters</h4>
@ -18480,7 +18480,7 @@ user_function (<a class="link" href="GtkWidget.html" title="GtkWidget"><span cla
toplevel window associated to the <em class="parameter"><code>widget</code></em>
changes.</p>
<p>To receive this signal the <a href="https://developer.gnome.org/gdk3/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> associated to the widget
needs to enable the <a href="https://developer.gnome.org/gdk3/gdk3-Events.html#GDK-STRUCTURE-MASK:CAPS"><span class="type">GDK_STRUCTURE_MASK</span></a> mask. GDK will enable
needs to enable the <a href="https://developer.gnome.org/gdk4/gdk4-Events.html#GDK-STRUCTURE-MASK:CAPS"><span class="type">GDK_STRUCTURE_MASK</span></a> mask. GDK will enable
this mask automatically for all new windows.</p>
<div class="refsect3">
<a name="GtkWidget-window-state-event.parameters"></a><h4>Parameters</h4>