New upstream version 3.24.34

This commit is contained in:
Simon McVittie
2022-06-01 16:13:05 +01:00
473 changed files with 306973 additions and 738624 deletions

View File

@ -206,7 +206,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkWindow</span> *
<a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="returnvalue">GdkWindow</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkTextView.html#gtk-text-view-get-window" title="gtk_text_view_get_window ()">gtk_text_view_get_window</a> <span class="c_punctuation">()</span>
@ -785,7 +785,7 @@
</colgroup>
<tbody><tr>
<td class="property_type">
<span class="type">GdkColor</span> *</td>
<a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</td>
<td class="property_name"><a class="link" href="GtkTextView.html#GtkTextView--s-error-underline-color" title="The “error-underline-color” style property">error-underline-color</a></td>
<td class="property_flags">Read</td>
</tr></tbody>
@ -967,14 +967,14 @@ types related to the text widget and how they work together.</p>
6
7
8</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="n">textview</span><span class="p">.</span><span class="n">view</span>
<span class="err">├──</span> <span class="n">border</span><span class="p">.</span><span class="n">top</span>
<span class="err">├──</span> <span class="n">border</span><span class="p">.</span><span class="n">left</span>
<span class="err">├──</span> <span class="n">text</span>
<span class="err"></span> <span class="err">╰──</span> <span class="p">[</span><span class="n">selection</span><span class="p">]</span>
<span class="err">├──</span> <span class="n">border</span><span class="p">.</span><span class="n">right</span>
<span class="err">├──</span> <span class="n">border</span><span class="p">.</span><span class="n">bottom</span>
<span class="err">╰──</span> <span class="p">[</span><span class="n">window</span><span class="p">.</span><span class="n">popup</span><span class="p">]</span></pre></td>
<td class="listing_code"><pre class="programlisting"><span class="n">textview</span><span class="p">.</span><span class="n">view</span><span class="w"></span>
<span class="err">├──</span><span class="w"> </span><span class="n">border</span><span class="p">.</span><span class="n">top</span><span class="w"></span>
<span class="err">├──</span><span class="w"> </span><span class="n">border</span><span class="p">.</span><span class="n">left</span><span class="w"></span>
<span class="err">├──</span><span class="w"> </span><span class="n">text</span><span class="w"></span>
<span class="err"></span><span class="w"> </span><span class="err">╰──</span><span class="w"> </span><span class="p">[</span><span class="n">selection</span><span class="p">]</span><span class="w"></span>
<span class="err">├──</span><span class="w"> </span><span class="n">border</span><span class="p">.</span><span class="n">right</span><span class="w"></span>
<span class="err">├──</span><span class="w"> </span><span class="n">border</span><span class="p">.</span><span class="n">bottom</span><span class="w"></span>
<span class="err">╰──</span><span class="w"> </span><span class="p">[</span><span class="n">window</span><span class="p">.</span><span class="n">popup</span><span class="p">]</span><span class="w"></span></pre></td>
</tr>
</tbody>
</table>
@ -1414,7 +1414,7 @@ buffer, it it isnt there already.</p>
<a name="gtk-text-view-get-visible-rect"></a><h3>gtk_text_view_get_visible_rect ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_text_view_get_visible_rect (<em class="parameter"><code><a class="link" href="GtkTextView.html" title="GtkTextView"><span class="type">GtkTextView</span></a> *text_view</code></em>,
<em class="parameter"><code><span class="type">GdkRectangle</span> *visible_rect</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *visible_rect</code></em>);</pre>
<p>Fills <em class="parameter"><code>visible_rect</code></em>
with the currently-visible
region of the buffer, in buffer coordinates. Convert to window coordinates
@ -1448,7 +1448,7 @@ with <a class="link" href="GtkTextView.html#gtk-text-view-buffer-to-window-coord
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_text_view_get_iter_location (<em class="parameter"><code><a class="link" href="GtkTextView.html" title="GtkTextView"><span class="type">GtkTextView</span></a> *text_view</code></em>,
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
<em class="parameter"><code><span class="type">GdkRectangle</span> *location</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *location</code></em>);</pre>
<p>Gets a rectangle which roughly contains the character at <em class="parameter"><code>iter</code></em>
.
The rectangle position is in buffer coordinates; use
@ -1489,8 +1489,8 @@ coordinates to coordinates for one of the windows in the text view.</p>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_text_view_get_cursor_locations (<em class="parameter"><code><a class="link" href="GtkTextView.html" title="GtkTextView"><span class="type">GtkTextView</span></a> *text_view</code></em>,
<em class="parameter"><code>const <a class="link" href="GtkTextIter.html" title="GtkTextIter"><span class="type">GtkTextIter</span></a> *iter</code></em>,
<em class="parameter"><code><span class="type">GdkRectangle</span> *strong</code></em>,
<em class="parameter"><code><span class="type">GdkRectangle</span> *weak</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *strong</code></em>,
<em class="parameter"><code><a href="../html/gdk3-Points-Rectangles-and-Regions.html#GdkRectangle"><span class="type">GdkRectangle</span></a> *weak</code></em>);</pre>
<p>Given an <em class="parameter"><code>iter</code></em>
within a text layout, determine the positions of the
strong and weak cursors if the insertion point is at that
@ -1883,10 +1883,10 @@ coordinates, storing the result in (<em class="parameter"><code>buffer_x</code><
<hr>
<div class="refsect2">
<a name="gtk-text-view-get-window"></a><h3>gtk_text_view_get_window ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkWindow</span> *
<pre class="programlisting"><a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="returnvalue">GdkWindow</span></a> *
gtk_text_view_get_window (<em class="parameter"><code><a class="link" href="GtkTextView.html" title="GtkTextView"><span class="type">GtkTextView</span></a> *text_view</code></em>,
<em class="parameter"><code><a class="link" href="GtkTextView.html#GtkTextWindowType" title="enum GtkTextWindowType"><span class="type">GtkTextWindowType</span></a> win</code></em>);</pre>
<p>Retrieves the <span class="type">GdkWindow</span> corresponding to an area of the text view;
<p>Retrieves the <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> corresponding to an area of the text view;
possible windows include the overall widget window, child windows
on the left, right, top, bottom, and the window that displays the
text buffer. Windows are <code class="literal">NULL</code> and nonexistent if their width or
@ -1916,7 +1916,7 @@ realized.</p>
</div>
<div class="refsect3">
<a name="gtk-text-view-get-window.returns"></a><h4>Returns</h4>
<p>a <span class="type">GdkWindow</span>, or <code class="literal">NULL</code>. </p>
<p>a <a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a>, or <code class="literal">NULL</code>. </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="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
</div>
@ -1925,7 +1925,7 @@ realized.</p>
<a name="gtk-text-view-get-window-type"></a><h3>gtk_text_view_get_window_type ()</h3>
<pre class="programlisting"><a class="link" href="GtkTextView.html#GtkTextWindowType" title="enum GtkTextWindowType"><span class="returnvalue">GtkTextWindowType</span></a>
gtk_text_view_get_window_type (<em class="parameter"><code><a class="link" href="GtkTextView.html" title="GtkTextView"><span class="type">GtkTextView</span></a> *text_view</code></em>,
<em class="parameter"><code><span class="type">GdkWindow</span> *window</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
<p>Usually used to find out which window an event corresponds to.</p>
<p>If you connect to an event signal on <em class="parameter"><code>text_view</code></em>
, this function
@ -3492,7 +3492,7 @@ and should be freed with <a class="link" href="GtkTextTag.html#gtk-text-attribut
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_text_view_im_context_filter_keypress
(<em class="parameter"><code><a class="link" href="GtkTextView.html" title="GtkTextView"><span class="type">GtkTextView</span></a> *text_view</code></em>,
<em class="parameter"><code><span class="type">GdkEventKey</span> *event</code></em>);</pre>
<em class="parameter"><code><a href="../html/gdk3-Event-Structures.html#GdkEventKey"><span class="type">GdkEventKey</span></a> *event</code></em>);</pre>
<p>Allow the <a class="link" href="GtkTextView.html" title="GtkTextView"><span class="type">GtkTextView</span></a> input method to internally handle key press
and release events. If this function returns <code class="literal">TRUE</code>, then no further
processing should be done for this key event. See
@ -3523,24 +3523,24 @@ and the default key event handling of the <a class="link" href="GtkTextView.html
16
17
18</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="k">static</span> <span class="n">gboolean</span>
<span class="nf">gtk_foo_bar_key_press_event</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">GdkEventKey</span> <span class="o">*</span><span class="n">event</span><span class="p">)</span>
<span class="p">{</span>
<span class="n">guint</span> <span class="n">keyval</span><span class="p">;</span>
<td class="listing_code"><pre class="programlisting"><span class="k">static</span><span class="w"> </span><span class="n">gboolean</span><span class="w"></span>
<span class="nf">gtk_foo_bar_key_press_event</span><span class="w"> </span><span class="p">(</span><span class="n">GtkWidget</span><span class="w"> </span><span class="o">*</span><span class="n">widget</span><span class="p">,</span><span class="w"></span>
<span class="w"> </span><span class="n">GdkEventKey</span><span class="w"> </span><span class="o">*</span><span class="n">event</span><span class="p">)</span><span class="w"></span>
<span class="p">{</span><span class="w"></span>
<span class="w"> </span><span class="n">guint</span><span class="w"> </span><span class="n">keyval</span><span class="p">;</span><span class="w"></span>
<span class="n">gdk_event_get_keyval</span> <span class="p">((</span><span class="n">GdkEvent</span><span class="o">*</span><span class="p">)</span><span class="n">event</span><span class="p">,</span> <span class="o">&amp;</span><span class="n">keyval</span><span class="p">);</span>
<span class="w"> </span><span class="n">gdk_event_get_keyval</span><span class="w"> </span><span class="p">((</span><span class="n">GdkEvent</span><span class="o">*</span><span class="p">)</span><span class="n">event</span><span class="p">,</span><span class="w"> </span><span class="o">&amp;</span><span class="n">keyval</span><span class="p">);</span><span class="w"></span>
<span class="k">if</span> <span class="p">(</span><span class="n">keyval</span> <span class="o">==</span> <span class="n">GDK_KEY_Return</span> <span class="o">||</span> <span class="n">keyval</span> <span class="o">==</span> <span class="n">GDK_KEY_KP_Enter</span><span class="p">)</span>
<span class="p">{</span>
<span class="k">if</span> <span class="p">(</span><span class="n">gtk_text_view_im_context_filter_keypress</span> <span class="p">(</span><span class="n">GTK_TEXT_VIEW</span> <span class="p">(</span><span class="n">widget</span><span class="p">),</span> <span class="n">event</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="w"> </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="n">keyval</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="n">GDK_KEY_Return</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="n">keyval</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="n">GDK_KEY_KP_Enter</span><span class="p">)</span><span class="w"></span>
<span class="w"> </span><span class="p">{</span><span class="w"></span>
<span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="n">gtk_text_view_im_context_filter_keypress</span><span class="w"> </span><span class="p">(</span><span class="n">GTK_TEXT_VIEW</span><span class="w"> </span><span class="p">(</span><span class="n">widget</span><span class="p">),</span><span class="w"> </span><span class="n">event</span><span class="p">))</span><span class="w"></span>
<span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="n">TRUE</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="p">}</span><span class="w"></span>
<span class="c1">// Do some stuff</span>
<span class="w"> </span><span class="c1">// Do some stuff</span>
<span class="k">return</span> <span class="n">GTK_WIDGET_CLASS</span> <span class="p">(</span><span class="n">gtk_foo_bar_parent_class</span><span class="p">)</span><span class="o">-&gt;</span><span class="n">key_press_event</span> <span class="p">(</span><span class="n">widget</span><span class="p">,</span> <span class="n">event</span><span class="p">);</span>
<span class="p">}</span></pre></td>
<span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="n">GTK_WIDGET_CLASS</span><span class="w"> </span><span class="p">(</span><span class="n">gtk_foo_bar_parent_class</span><span class="p">)</span><span class="o">-&gt;</span><span class="n">key_press_event</span><span class="w"> </span><span class="p">(</span><span class="n">widget</span><span class="p">,</span><span class="w"> </span><span class="n">event</span><span class="p">);</span><span class="w"></span>
<span class="p">}</span><span class="w"></span></pre></td>
</tr>
</tbody>
</table>
@ -4357,7 +4357,7 @@ to the padding from the theme.</p>
<a name="GtkTextView.style-property-details"></a><h2>Style Property Details</h2>
<div class="refsect2">
<a name="GtkTextView--s-error-underline-color"></a><h3>The <code class="literal">“error-underline-color”</code> style property</h3>
<pre class="programlisting"> “error-underline-color” <span class="type">GdkColor</span> *</pre>
<pre class="programlisting"> “error-underline-color” <a href="../html/gdk3-Colors.html#GdkColor"><span class="type">GdkColor</span></a> *</pre>
<p>Color with which to draw error-indication underlines.</p>
<p>Owner: GtkTextView</p>
<p>Flags: Read</p>
@ -4590,8 +4590,8 @@ extended at <em class="parameter"><code>location</code></em>
</div>
<div class="refsect3">
<a name="GtkTextView-extend-selection.returns"></a><h4>Returns</h4>
<p> <code class="literal">GDK_EVENT_STOP</code> to stop other handlers from being invoked for the
event. <code class="literal">GDK_EVENT_PROPAGATE</code> to propagate the event further.</p>
<p> <a href="../html/gdk3-Events.html#GDK-EVENT-STOP:CAPS"><code class="literal">GDK_EVENT_STOP</code></a> to stop other handlers from being invoked for the
event. <a href="../html/gdk3-Events.html#GDK-EVENT-PROPAGATE:CAPS"><code class="literal">GDK_EVENT_PROPAGATE</code></a> to propagate the event further.</p>
</div>
<p>Flags: Run Last</p>
<p class="since">Since: <a class="link" href="api-index-3-16.html#api-index-3.16">3.16</a></p>