New upstream version 3.24.11

2019-09-04 16:25:11 +01:00
parent 44e14a6256 622111f1ca
commit e2ad7f7afe
635 changed files with 96293 additions and 94473 deletions
--- a/docs/reference/gtk/html/GtkMenu.html
+++ b/docs/reference/gtk/html/GtkMenu.html
@ -8,7 +8,7 @@
 <link rel="up" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
 <link rel="prev" href="GtkComboBoxText.html" title="GtkComboBoxText">
 <link rel="next" href="GtkMenuBar.html" title="GtkMenuBar">
-<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">
@ -337,7 +337,7 @@
 <td class="property_flags">Read / Write</td>
 </tr>
 <tr>
-<td class="property_type"><a href="https://developer.gnome.org/gdk4/GdkSurface.html#GdkAnchorHints"><span class="type">GdkAnchorHints</span></a></td>
+<td class="property_type"><span class="type">GdkAnchorHints</span></td>
 <td class="property_name"><a class="link" href="GtkMenu.html#GtkMenu--anchor-hints" title="The “anchor-hints” property">anchor-hints</a></td>
 <td class="property_flags">Read / Write / Construct</td>
 </tr>
@ -551,9 +551,9 @@ can pop up a menu when the 3rd mouse button is pressed.  </p>
        <td class="listing_lines" align="right"><pre>1
 2
 3</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="c1">// connect our handler which will popup the menu</span>
-<span class="n">g_signal_connect_swapped</span> <span class="p">(</span><span class="n">window</span><span class="p">,</span> <span class="s">&quot;button_press_event&quot;</span><span class="p">,</span>
-<span class="n">G_CALLBACK</span> <span class="p">(</span><span class="n">my_popup_handler</span><span class="p">),</span> <span class="n">menu</span><span class="p">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="comment">// connect our handler which will popup the menu</span>
+<span class="function">g_signal_connect_swapped</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">window</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"button_press_event"</span><span class="symbol">,</span>
+<span class="function">G_CALLBACK</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">my_popup_handler</span><span class="symbol">),</span><span class="normal"> menu</span><span class="symbol">);</span></pre></td>
      </tr>
    </tbody>
  </table>
@ -594,33 +594,33 @@ can pop up a menu when the 3rd mouse button is pressed.  </p>
 25
 26
 27</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="k">static</span> <span class="n">gint</span>
-<span class="nf">my_popup_handler</span> <span class="p">(</span><span class="n">GtkWidget</span> <span class="o">*</span><span class="n">widget</span><span class="p">,</span> <span class="n">GdkEvent</span> <span class="o">*</span><span class="n">event</span><span class="p">)</span>
-<span class="p">{</span>
-  <span class="n">GtkMenu</span> <span class="o">*</span><span class="n">menu</span><span class="p">;</span>
-  <span class="n">GdkEventButton</span> <span class="o">*</span><span class="n">event_button</span><span class="p">;</span>
+        <td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> gint</span>
+<span class="function">my_popup_handler</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">widget</span><span class="symbol">,</span><span class="normal"> </span><span class="usertype">GdkEvent</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">event</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="usertype">GtkMenu</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">menu</span><span class="symbol">;</span>
+<span class="normal">  </span><span class="usertype">GdkEventButton</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">event_button</span><span class="symbol">;</span>

-  <span class="n">g_return_val_if_fail</span> <span class="p">(</span><span class="n">widget</span> <span class="o">!=</span> <span class="nb">NULL</span><span class="p">,</span> <span class="n">FALSE</span><span class="p">);</span>
-  <span class="n">g_return_val_if_fail</span> <span class="p">(</span><span class="n">GTK_IS_MENU</span> <span class="p">(</span><span class="n">widget</span><span class="p">),</span> <span class="n">FALSE</span><span class="p">);</span>
-  <span class="n">g_return_val_if_fail</span> <span class="p">(</span><span class="n">event</span> <span class="o">!=</span> <span class="nb">NULL</span><span class="p">,</span> <span class="n">FALSE</span><span class="p">);</span>
+<span class="normal">  </span><span class="function">g_return_val_if_fail</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget </span><span class="symbol">!=</span><span class="normal"> NULL</span><span class="symbol">,</span><span class="normal"> FALSE</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="function">g_return_val_if_fail</span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_IS_MENU</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">),</span><span class="normal"> FALSE</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="function">g_return_val_if_fail</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">event </span><span class="symbol">!=</span><span class="normal"> NULL</span><span class="symbol">,</span><span class="normal"> FALSE</span><span class="symbol">);</span>

-  <span class="c1">// The &quot;widget&quot; is the menu that was supplied when </span>
-  <span class="c1">// g_signal_connect_swapped() was called.</span>
-  <span class="n">menu</span> <span class="o">=</span> <span class="n">GTK_MENU</span> <span class="p">(</span><span class="n">widget</span><span class="p">);</span>
+<span class="normal">  </span><span class="comment">// The "widget" is the menu that was supplied when </span>
+<span class="normal">  </span><span class="comment">// g_signal_connect_swapped() was called.</span>
+<span class="normal">  menu </span><span class="symbol">=</span><span class="normal"> </span><span class="function">GTK_MENU</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">);</span>

-  <span class="k">if</span> <span class="p">(</span><span class="n">event</span><span class="o">-&gt;</span><span class="n">type</span> <span class="o">==</span> <span class="n">GDK_BUTTON_PRESS</span><span class="p">)</span>
-    <span class="p">{</span>
-      <span class="n">event_button</span> <span class="o">=</span> <span class="p">(</span><span class="n">GdkEventButton</span> <span class="o">*</span><span class="p">)</span> <span class="n">event</span><span class="p">;</span>
-      <span class="k">if</span> <span class="p">(</span><span class="n">event_button</span><span class="o">-&gt;</span><span class="n">button</span> <span class="o">==</span> <span class="n">GDK_BUTTON_SECONDARY</span><span class="p">)</span>
-        <span class="p">{</span>
-          <span class="n">gtk_menu_popup</span> <span class="p">(</span><span class="n">menu</span><span class="p">,</span> <span class="nb">NULL</span><span class="p">,</span> <span class="nb">NULL</span><span class="p">,</span> <span class="nb">NULL</span><span class="p">,</span> <span class="nb">NULL</span><span class="p">,</span> 
-                          <span class="n">event_button</span><span class="o">-&gt;</span><span class="n">button</span><span class="p">,</span> <span class="n">event_button</span><span class="o">-&gt;</span><span class="n">time</span><span class="p">);</span>
-          <span class="k">return</span> <span class="n">TRUE</span><span class="p">;</span>
-        <span class="p">}</span>
-    <span class="p">}</span>
+<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">event</span><span class="symbol">-&gt;</span><span class="normal">type </span><span class="symbol">==</span><span class="normal"> GDK_BUTTON_PRESS</span><span class="symbol">)</span>
+<span class="normal">    </span><span class="cbracket">{</span>
+<span class="normal">      event_button </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">GdkEventButton </span><span class="symbol">*)</span><span class="normal"> event</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">event_button</span><span class="symbol">-&gt;</span><span class="normal">button </span><span class="symbol">==</span><span class="normal"> GDK_BUTTON_SECONDARY</span><span class="symbol">)</span>
+<span class="normal">        </span><span class="cbracket">{</span>
+<span class="normal">          </span><span class="function"><a href="GtkMenu.html#gtk-menu-popup">gtk_menu_popup</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">menu</span><span class="symbol">,</span><span class="normal"> NULL</span><span class="symbol">,</span><span class="normal"> NULL</span><span class="symbol">,</span><span class="normal"> NULL</span><span class="symbol">,</span><span class="normal"> NULL</span><span class="symbol">,</span><span class="normal"> </span>
+<span class="normal">                          event_button</span><span class="symbol">-&gt;</span><span class="normal">button</span><span class="symbol">,</span><span class="normal"> event_button</span><span class="symbol">-&gt;</span><span class="normal">time</span><span class="symbol">);</span>
+<span class="normal">          </span><span class="keyword">return</span><span class="normal"> TRUE</span><span class="symbol">;</span>
+<span class="normal">        </span><span class="cbracket">}</span>
+<span class="normal">    </span><span class="cbracket">}</span>

-  <span class="k">return</span> <span class="n">FALSE</span><span class="p">;</span>
-<span class="p">}</span></pre></td>
+<span class="normal">  </span><span class="keyword">return</span><span class="normal"> FALSE</span><span class="symbol">;</span>
+<span class="cbracket">}</span></pre></td>
      </tr>
    </tbody>
  </table>
@ -640,12 +640,12 @@ can pop up a menu when the 3rd mouse button is pressed.  </p>
 4
 5
 6</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="n">menu</span>
-<span class="err">├──</span> <span class="n">arrow</span><span class="p">.</span><span class="n">top</span>
-<span class="err">├──</span> <span class="o">&lt;</span><span class="n">child</span><span class="o">&gt;</span>
-<span class="err">┊</span>
-<span class="err">├──</span> <span class="o">&lt;</span><span class="n">child</span><span class="o">&gt;</span>
-<span class="err">╰──</span> <span class="n">arrow</span><span class="p">.</span><span class="n">bottom</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="normal">menu</span>
+<span class="normal">├── arrow</span><span class="symbol">.</span><span class="normal">top</span>
+<span class="normal">├── </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
+<span class="normal">┊</span>
+<span class="normal">├── </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
+<span class="normal">╰── arrow</span><span class="symbol">.</span><span class="normal">bottom</span></pre></td>
      </tr>
    </tbody>
  </table>
@ -848,9 +848,9 @@ rightmost, uppermost and lower column and row numbers of the table.
 <pre class="programlisting"><span class="returnvalue">void</span>
 gtk_menu_popup_at_rect (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
                        <em class="parameter"><code><span class="type">GdkWindow</span> *rect_window</code></em>,
-                        <em class="parameter"><code>const <a href="https://developer.gnome.org/gdk4/gdk4-Points-Rectangles-and-Regions.html#GdkRectangle-struct"><span class="type">GdkRectangle</span></a> *rect</code></em>,
-                        <em class="parameter"><code><a href="https://developer.gnome.org/gdk4/GdkSurface.html#GdkGravity"><span class="type">GdkGravity</span></a> rect_anchor</code></em>,
-                        <em class="parameter"><code><a href="https://developer.gnome.org/gdk4/GdkSurface.html#GdkGravity"><span class="type">GdkGravity</span></a> menu_anchor</code></em>,
+                        <em class="parameter"><code>const <span class="type">GdkRectangle</span> *rect</code></em>,
+                        <em class="parameter"><code><span class="type">GdkGravity</span> rect_anchor</code></em>,
+                        <em class="parameter"><code><span class="type">GdkGravity</span> menu_anchor</code></em>,
                        <em class="parameter"><code>const <span class="type">GdkEvent</span> *trigger_event</code></em>);</pre>
 <p>Displays <em class="parameter"><code>menu</code></em>
 and makes it available for selection.</p>
@ -898,7 +898,7 @@ is relative to. </p></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>rect</p></td>
-<td class="parameter_description"><p>the <a href="https://developer.gnome.org/gdk4/gdk4-Points-Rectangles-and-Regions.html#GdkRectangle-struct"><span class="type">GdkRectangle</span></a> to align <em class="parameter"><code>menu</code></em>
+<td class="parameter_description"><p>the <span class="type">GdkRectangle</span> to align <em class="parameter"><code>menu</code></em>
 with. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL must not be passed as the value in, out, in-out; or as a return value."><span class="acronym">not nullable</span></acronym>]</span></td>
 </tr>
@ -933,8 +933,8 @@ to align with <em class="parameter"><code>rect</code></em>
 <pre class="programlisting"><span class="returnvalue">void</span>
 gtk_menu_popup_at_widget (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
                          <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/gdk4/GdkSurface.html#GdkGravity"><span class="type">GdkGravity</span></a> widget_anchor</code></em>,
-                          <em class="parameter"><code><a href="https://developer.gnome.org/gdk4/GdkSurface.html#GdkGravity"><span class="type">GdkGravity</span></a> menu_anchor</code></em>,
+                          <em class="parameter"><code><span class="type">GdkGravity</span> widget_anchor</code></em>,
+                          <em class="parameter"><code><span class="type">GdkGravity</span> menu_anchor</code></em>,
                          <em class="parameter"><code>const <span class="type">GdkEvent</span> *trigger_event</code></em>);</pre>
 <p>Displays <em class="parameter"><code>menu</code></em>
 and makes it available for selection.</p>
@ -1052,7 +1052,7 @@ out how it was actually positioned.</p>
 <a name="gtk-menu-popup-for-device"></a><h3>gtk_menu_popup_for_device ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>
 gtk_menu_popup_for_device (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</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><span class="type">GdkDevice</span> *device</code></em>,
                           <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *parent_menu_shell</code></em>,
                           <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *parent_menu_item</code></em>,
                           <em class="parameter"><code><a class="link" href="GtkMenu.html#GtkMenuPositionFunc" title="GtkMenuPositionFunc ()"><span class="type">GtkMenuPositionFunc</span></a> func</code></em>,
@ -1110,7 +1110,7 @@ have this problem.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>device</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_description"><p>a <span class="type">GdkDevice</span>. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
 </tr>
 <tr>
@ -1464,7 +1464,7 @@ and should not be modified or freed.</p>
 gtk_menu_set_monitor (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
                      <em class="parameter"><code><span class="type">gint</span> monitor_num</code></em>);</pre>
 <p>Informs GTK+ on which monitor a menu should be popped up.
-See <a href="https://developer.gnome.org/gdk4/GdkMonitor.html#gdk-monitor-get-geometry"><code class="function">gdk_monitor_get_geometry()</code></a>.</p>
+See <code class="function">gdk_monitor_get_geometry()</code>.</p>
 <p>This function should be called from a <a class="link" href="GtkMenu.html#GtkMenuPositionFunc" title="GtkMenuPositionFunc ()"><span class="type">GtkMenuPositionFunc</span></a>
 if the menu should not appear on the same monitor as the pointer.
 This information can’t be reliably inferred from the coordinates
@ -1529,7 +1529,7 @@ be popped up or -1, if no monitor has been set</p>
 <a name="gtk-menu-place-on-monitor"></a><h3>gtk_menu_place_on_monitor ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>
 gtk_menu_place_on_monitor (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
-                           <em class="parameter"><code><a href="https://developer.gnome.org/gdk4/GdkMonitor.html#GdkMonitor-struct"><span class="type">GdkMonitor</span></a> *monitor</code></em>);</pre>
+                           <em class="parameter"><code><span class="type">GdkMonitor</span> *monitor</code></em>);</pre>
 <p>Places <em class="parameter"><code>menu</code></em>
 on the given monitor.</p>
 <div class="refsect3">
@ -2087,13 +2087,13 @@ menu item is selected.</p>
 <hr>
 <div class="refsect2">
 <a name="GtkMenu--anchor-hints"></a><h3>The <code class="literal">“anchor-hints”</code> property</h3>
-<pre class="programlisting">  “anchor-hints”             <a href="https://developer.gnome.org/gdk4/GdkSurface.html#GdkAnchorHints"><span class="type">GdkAnchorHints</span></a></pre>
+<pre class="programlisting">  “anchor-hints”             <span class="type">GdkAnchorHints</span></pre>
 <p>Positioning hints for aligning the menu relative to a rectangle.</p>
 <p>These hints determine how the menu should be positioned in the case that
 the menu would fall off-screen if placed in its ideal position.</p>
 <p><span class="inlinemediaobject"><img src="popup-flip.png"></span></p>
-<p>For example, <a href="https://developer.gnome.org/gdk4/GdkSurface.html#GDK-ANCHOR-FLIP-Y:CAPS"><code class="literal">GDK_ANCHOR_FLIP_Y</code></a> will replace <a href="https://developer.gnome.org/gdk4/GdkSurface.html#GDK-GRAVITY-NORTH-WEST:CAPS"><code class="literal">GDK_GRAVITY_NORTH_WEST</code></a> with
-<a href="https://developer.gnome.org/gdk4/GdkSurface.html#GDK-GRAVITY-SOUTH-WEST:CAPS"><code class="literal">GDK_GRAVITY_SOUTH_WEST</code></a> and vice versa if the menu extends beyond the
+<p>For example, <code class="literal">GDK_ANCHOR_FLIP_Y</code> will replace <code class="literal">GDK_GRAVITY_NORTH_WEST</code> with
+<code class="literal">GDK_GRAVITY_SOUTH_WEST</code> and vice versa if the menu extends beyond the
 bottom edge of the monitor.</p>
 <p>See <a class="link" href="GtkMenu.html#gtk-menu-popup-at-rect" title="gtk_menu_popup_at_rect ()"><code class="function">gtk_menu_popup_at_rect()</code></a>, <a class="link" href="GtkMenu.html#gtk-menu-popup-at-widget" title="gtk_menu_popup_at_widget ()"><code class="function">gtk_menu_popup_at_widget()</code></a>,
 <a class="link" href="GtkMenu.html#gtk-menu-popup-at-pointer" title="gtk_menu_popup_at_pointer ()"><code class="function">gtk_menu_popup_at_pointer()</code></a>, <a class="link" href="GtkMenu.html#GtkMenu--rect-anchor-dx" title="The “rect-anchor-dx” property"><span class="type">“rect-anchor-dx”</span></a>,
@ -2448,6 +2448,6 @@ backend can't obtain it. </p></td>
 </div>
 </div>
 <div class="footer">
-<hr>Generated by GTK-Doc V1.30.1</div>
+<hr>Generated by GTK-Doc V1.29</div>
 </body>
 </html>