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

New upstream version 3.22.28

Browse Source
This commit is contained in:
Jeremy Bicha
2018-02-15 04:41:25 -05:00
parent d4022898c0 463ee95136
commit 55d2e9a013
652 changed files with 498643 additions and 49781 deletions
Download Patch File Download Diff File Expand all files Collapse all files

164
docs/reference/gtk/html/GtkScale.html
View File

@ -8,7 +8,7 @@
<link rel="up" href="NumericEntry.html" title="Numeric and Text Data Entry">
<link rel="prev" href="GtkEntryCompletion.html" title="GtkEntryCompletion">
<link rel="next" href="GtkSpinButton.html" title="GtkSpinButton">
<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@ -94,7 +94,7 @@
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GtkScale.html#gtk-scale-get-digits" title="gtk_scale_get_digits ()">gtk_scale_get_digits</a> <span class="c_punctuation">()</span>
@ -102,7 +102,7 @@
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkScale.html#gtk-scale-get-draw-value" title="gtk_scale_get_draw_value ()">gtk_scale_get_draw_value</a> <span class="c_punctuation">()</span>
@ -110,7 +110,7 @@
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkScale.html#gtk-scale-get-has-origin" title="gtk_scale_get_has_origin ()">gtk_scale_get_has_origin</a> <span class="c_punctuation">()</span>
@ -126,7 +126,7 @@
</tr>
<tr>
<td class="function_type">
<a href="../pango/pango-Layout-Objects.html#PangoLayout-struct"><span class="returnvalue">PangoLayout</span></a> *
<span class="returnvalue">PangoLayout</span> *
</td>
<td class="function_name">
<a class="link" href="GtkScale.html#gtk-scale-get-layout" title="gtk_scale_get_layout ()">gtk_scale_get_layout</a> <span class="c_punctuation">()</span>
@ -169,17 +169,17 @@
</colgroup>
<tbody>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
<td class="property_type"><span class="type">gint</span></td>
<td class="property_name"><a class="link" href="GtkScale.html#GtkScale--digits" title="The “digits” property">digits</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkScale.html#GtkScale--draw-value" title="The “draw-value” property">draw-value</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkScale.html#GtkScale--has-origin" title="The “has-origin” property">has-origin</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -201,12 +201,12 @@
</colgroup>
<tbody>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
<td class="property_type"><span class="type">gint</span></td>
<td class="property_name"><a class="link" href="GtkScale.html#GtkScale--s-slider-length" title="The “slider-length” style property">slider-length</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
<td class="property_type"><span class="type">gint</span></td>
<td class="property_name"><a class="link" href="GtkScale.html#GtkScale--s-value-spacing" title="The “value-spacing” style property">value-spacing</a></td>
<td class="property_flags">Read</td>
</tr>
@ -223,9 +223,9 @@
</colgroup>
<tbody><tr>
<td class="signal_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>*</td>
<span class="returnvalue">gchar</span>*</td>
<td class="signal_name"><a class="link" href="GtkScale.html#GtkScale-format-value" title="The “format-value” signal">format-value</a></td>
<td class="signal_flags"><a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
<td class="signal_flags">Run Last</td>
</tr></tbody>
</table></div>
</div>
@ -244,8 +244,8 @@
</div>
<div class="refsect1">
<a name="GtkScale.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen"> <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
<span class="lineart">╰──</span> <a href="../gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
<pre class="screen"> GObject
<span class="lineart">╰──</span> GInitiallyUnowned
<span class="lineart">╰──</span> <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
<span class="lineart">╰──</span> <a class="link" href="GtkRange.html" title="GtkRange">GtkRange</a>
<span class="lineart">╰──</span> GtkScale
@ -310,24 +310,24 @@ the mark. It can be translated with the usual ”translatable” and
16
17
18</pre></td>
<td class="listing_code"><pre class="programlisting">scale<span class="gtkdoc opt">[.</span>fine<span class="gtkdoc opt">-</span>tune<span class="gtkdoc opt">][.</span>marks<span class="gtkdoc opt">-</span>before<span class="gtkdoc opt">][.</span>marks<span class="gtkdoc opt">-</span>after<span class="gtkdoc opt">]</span>
├── marks<span class="gtkdoc opt">.</span>top
│ ├── mark
│ ┊ ├── <span class="gtkdoc opt">[</span>label<span class="gtkdoc opt">]</span>
│ ┊ ╰── indicator
┊ ┊
│ ╰── mark
├── <span class="gtkdoc opt">[</span>value<span class="gtkdoc opt">]</span>
├── contents
│ ╰── trough
│ ├── slider
│ ├── <span class="gtkdoc opt">[</span>highlight<span class="gtkdoc opt">]</span>
│ ╰── <span class="gtkdoc opt">[</span>fill<span class="gtkdoc opt">]</span>
╰── marks<span class="gtkdoc opt">.</span>bottom
├── mark
┊ ├── indicator
┊ ╰── <span class="gtkdoc opt">[</span>label<span class="gtkdoc opt">]</span>
╰── mark</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="normal">scale</span><span class="symbol">[.</span><span class="normal">fine</span><span class="symbol">-</span><span class="normal">tune</span><span class="symbol">][.</span><span class="normal">marks</span><span class="symbol">-</span><span class="normal">before</span><span class="symbol">][.</span><span class="normal">marks</span><span class="symbol">-</span><span class="normal">after</span><span class="symbol">]</span>
<span class="normal">├── marks</span><span class="symbol">.</span><span class="normal">top</span>
<span class="normal">│ ├── mark</span>
<span class="normal">│ ┊ ├── </span><span class="symbol">[</span><span class="normal">label</span><span class="symbol">]</span>
<span class="normal">│ ┊ ╰── indicator</span>
<span class="normal">┊ ┊</span>
<span class="normal">│ ╰── mark</span>
<span class="normal">├── </span><span class="symbol">[</span><span class="normal">value</span><span class="symbol">]</span>
<span class="normal">├── contents</span>
<span class="normal">│ ╰── trough</span>
<span class="normal">│ ├── slider</span>
<span class="normal">│ ├── </span><span class="symbol">[</span><span class="normal">highlight</span><span class="symbol">]</span>
<span class="normal">│ ╰── </span><span class="symbol">[</span><span class="normal">fill</span><span class="symbol">]</span>
<span class="normal">╰── marks</span><span class="symbol">.</span><span class="normal">bottom</span>
<span class="normal"> ├── mark</span>
<span class="normal"> ┊ ├── indicator</span>
<span class="normal"> ┊ ╰── </span><span class="symbol">[</span><span class="normal">label</span><span class="symbol">]</span>
<span class="normal"> ╰── mark</span></pre></td>
</tr>
</tbody>
</table>
@ -381,8 +381,8 @@ gtk_scale_new (<em class="parameter"><code><a class="link" href="gtk3-Standard-E
</tr>
<tr>
<td class="parameter_name"><p>adjustment</p></td>
<td class="parameter_description"><p> the <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> which sets the range
of the scale, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to create a new adjustment. </p></td>
<td class="parameter_description"><p>the <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> which sets the range
of the scale, or <code class="literal">NULL</code> to create a new adjustment. </p></td>
<td class="parameter_annotations"><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>]</span></td>
</tr>
</tbody>
@ -399,9 +399,9 @@ of the scale, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code cla
<a name="gtk-scale-new-with-range"></a><h3>gtk_scale_new_with_range ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_scale_new_with_range (<em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkOrientation" title="enum GtkOrientation"><span class="type">GtkOrientation</span></a> orientation</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> min</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> max</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> step</code></em>);</pre>
<em class="parameter"><code><span class="type">gdouble</span> min</code></em>,
<em class="parameter"><code><span class="type">gdouble</span> max</code></em>,
<em class="parameter"><code><span class="type">gdouble</span> step</code></em>);</pre>
<p>Creates a new scale widget with the given orientation that lets the
user input a number between <em class="parameter"><code>min</code></em>
and <em class="parameter"><code>max</code></em>
@ -460,12 +460,12 @@ needs, use <a class="link" href="GtkScale.html#gtk-scale-set-digits" title="gtk_
<a name="gtk-scale-set-digits"></a><h3>gtk_scale_set_digits ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_scale_set_digits (<em class="parameter"><code><a class="link" href="GtkScale.html" title="GtkScale"><span class="type">GtkScale</span></a> *scale</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> digits</code></em>);</pre>
<em class="parameter"><code><span class="type">gint</span> digits</code></em>);</pre>
<p>Sets the number of decimal places that are displayed in the value. Also
causes the value of the adjustment to be rounded to this number of digits,
so the retrieved value matches the displayed one, if <a class="link" href="GtkScale.html#GtkScale--draw-value" title="The “draw-value” property"><span class="type">“draw-value”</span></a> is
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> when the value changes. If you want to enforce rounding the value when
<a class="link" href="GtkScale.html#GtkScale--draw-value" title="The “draw-value” property"><span class="type">“draw-value”</span></a> is <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, you can set <a class="link" href="GtkRange.html#GtkRange--round-digits" title="The “round-digits” property"><span class="type">“round-digits”</span></a> instead.</p>
<code class="literal">TRUE</code> when the value changes. If you want to enforce rounding the value when
<a class="link" href="GtkScale.html#GtkScale--draw-value" title="The “draw-value” property"><span class="type">“draw-value”</span></a> is <code class="literal">FALSE</code>, you can set <a class="link" href="GtkRange.html#GtkRange--round-digits" title="The “round-digits” property"><span class="type">“round-digits”</span></a> instead.</p>
<p>Note that rounding to a small number of digits can interfere with
the smooth autoscrolling that is built into <a class="link" href="GtkScale.html" title="GtkScale"><span class="type">GtkScale</span></a>. As an alternative,
you can use the <a class="link" href="GtkScale.html#GtkScale-format-value" title="The “format-value” signal"><span class="type">“format-value”</span></a> signal to format the displayed
@ -499,7 +499,7 @@ e.g. use 1 to display 1.0, 2 to display 1.00, etc</p></td>
<a name="gtk-scale-set-draw-value"></a><h3>gtk_scale_set_draw_value ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_scale_set_draw_value (<em class="parameter"><code><a class="link" href="GtkScale.html" title="GtkScale"><span class="type">GtkScale</span></a> *scale</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> draw_value</code></em>);</pre>
<em class="parameter"><code><span class="type">gboolean</span> draw_value</code></em>);</pre>
<p>Specifies whether the current value is displayed as a string next
to the slider.</p>
<div class="refsect3">
@ -518,7 +518,7 @@ to the slider.</p>
</tr>
<tr>
<td class="parameter_name"><p>draw_value</p></td>
<td class="parameter_description"><p><a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to draw the value</p></td>
<td class="parameter_description"><p><code class="literal">TRUE</code> to draw the value</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -530,8 +530,8 @@ to the slider.</p>
<a name="gtk-scale-set-has-origin"></a><h3>gtk_scale_set_has_origin ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_scale_set_has_origin (<em class="parameter"><code><a class="link" href="GtkScale.html" title="GtkScale"><span class="type">GtkScale</span></a> *scale</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> has_origin</code></em>);</pre>
<p>If <a class="link" href="GtkScale.html#GtkScale--has-origin" title="The “has-origin” property"><span class="type">“has-origin”</span></a> is set to <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> (the default), the scale will
<em class="parameter"><code><span class="type">gboolean</span> has_origin</code></em>);</pre>
<p>If <a class="link" href="GtkScale.html#GtkScale--has-origin" title="The “has-origin” property"><span class="type">“has-origin”</span></a> is set to <code class="literal">TRUE</code> (the default), the scale will
highlight the part of the trough between the origin (bottom or left side)
and the current value.</p>
<div class="refsect3">
@ -550,7 +550,7 @@ and the current value.</p>
</tr>
<tr>
<td class="parameter_name"><p>has_origin</p></td>
<td class="parameter_description"><p><a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the scale has an origin</p></td>
<td class="parameter_description"><p><code class="literal">TRUE</code> if the scale has an origin</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -591,7 +591,7 @@ gtk_scale_set_value_pos (<em class="parameter"><code><a class="link" href="GtkSc
<hr>
<div class="refsect2">
<a name="gtk-scale-get-digits"></a><h3>gtk_scale_get_digits ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<pre class="programlisting"><span class="returnvalue">gint</span>
gtk_scale_get_digits (<em class="parameter"><code><a class="link" href="GtkScale.html" title="GtkScale"><span class="type">GtkScale</span></a> *scale</code></em>);</pre>
<p>Gets the number of decimal places that are displayed in the value.</p>
<div class="refsect3">
@ -617,7 +617,7 @@ gtk_scale_get_digits (<em class="parameter"><code><a class="link" href="GtkScale
<hr>
<div class="refsect2">
<a name="gtk-scale-get-draw-value"></a><h3>gtk_scale_get_draw_value ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_scale_get_draw_value (<em class="parameter"><code><a class="link" href="GtkScale.html" title="GtkScale"><span class="type">GtkScale</span></a> *scale</code></em>);</pre>
<p>Returns whether the current value is displayed as a string
next to the slider.</p>
@ -644,7 +644,7 @@ next to the slider.</p>
<hr>
<div class="refsect2">
<a name="gtk-scale-get-has-origin"></a><h3>gtk_scale_get_has_origin ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_scale_get_has_origin (<em class="parameter"><code><a class="link" href="GtkScale.html" title="GtkScale"><span class="type">GtkScale</span></a> *scale</code></em>);</pre>
<p>Returns whether the scale has an origin.</p>
<div class="refsect3">
@ -664,7 +664,7 @@ gtk_scale_get_has_origin (<em class="parameter"><code><a class="link" href="GtkS
</div>
<div class="refsect3">
<a name="gtk-scale-get-has-origin.returns"></a><h4>Returns</h4>
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the scale has an origin.</p>
<p> <code class="literal">TRUE</code> if the scale has an origin.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-4.html#api-index-3.4">3.4</a></p>
</div>
@ -697,9 +697,9 @@ gtk_scale_get_value_pos (<em class="parameter"><code><a class="link" href="GtkSc
<hr>
<div class="refsect2">
<a name="gtk-scale-get-layout"></a><h3>gtk_scale_get_layout ()</h3>
<pre class="programlisting"><a href="../pango/pango-Layout-Objects.html#PangoLayout-struct"><span class="returnvalue">PangoLayout</span></a> *
<pre class="programlisting"><span class="returnvalue">PangoLayout</span> *
gtk_scale_get_layout (<em class="parameter"><code><a class="link" href="GtkScale.html" title="GtkScale"><span class="type">GtkScale</span></a> *scale</code></em>);</pre>
<p>Gets the <a href="../pango/pango-Layout-Objects.html#PangoLayout-struct"><span class="type">PangoLayout</span></a> used to display the scale. The returned
<p>Gets the <span class="type">PangoLayout</span> used to display the scale. The returned
object is owned by the scale so does not need to be freed by
the caller.</p>
<div class="refsect3">
@ -719,8 +719,8 @@ the caller.</p>
</div>
<div class="refsect3">
<a name="gtk-scale-get-layout.returns"></a><h4>Returns</h4>
<p> the <a href="../pango/pango-Layout-Objects.html#PangoLayout-struct"><span class="type">PangoLayout</span></a> for this scale,
or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the <a class="link" href="GtkScale.html#GtkScale--draw-value" title="The “draw-value” property"><span class="type">“draw-value”</span></a> property is <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>. </p>
<p>the <span class="type">PangoLayout</span> for this scale,
or <code class="literal">NULL</code> if the <a class="link" href="GtkScale.html#GtkScale--draw-value" title="The “draw-value” property"><span class="type">“draw-value”</span></a> property is <code class="literal">FALSE</code>. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.4</p>
@ -730,13 +730,13 @@ or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">N
<a name="gtk-scale-get-layout-offsets"></a><h3>gtk_scale_get_layout_offsets ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_scale_get_layout_offsets (<em class="parameter"><code><a class="link" href="GtkScale.html" title="GtkScale"><span class="type">GtkScale</span></a> *scale</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *x</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *y</code></em>);</pre>
<em class="parameter"><code><span class="type">gint</span> *x</code></em>,
<em class="parameter"><code><span class="type">gint</span> *y</code></em>);</pre>
<p>Obtains the coordinates where the scale will draw the
<a href="../pango/pango-Layout-Objects.html#PangoLayout-struct"><span class="type">PangoLayout</span></a> representing the text in the scale. Remember
when using the <a href="../pango/pango-Layout-Objects.html#PangoLayout-struct"><span class="type">PangoLayout</span></a> function you need to convert to
and from pixels using <a href="../pango/pango-Glyph-Storage.html#PANGO-PIXELS:CAPS"><code class="function">PANGO_PIXELS()</code></a> or <a href="../pango/pango-Glyph-Storage.html#PANGO-SCALE:CAPS"><span class="type">PANGO_SCALE</span></a>. </p>
<p>If the <a class="link" href="GtkScale.html#GtkScale--draw-value" title="The “draw-value” property"><span class="type">“draw-value”</span></a> property is <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, the return
<span class="type">PangoLayout</span> representing the text in the scale. Remember
when using the <span class="type">PangoLayout</span> function you need to convert to
and from pixels using <code class="function">PANGO_PIXELS()</code> or <span class="type">PANGO_SCALE</span>. </p>
<p>If the <a class="link" href="GtkScale.html#GtkScale--draw-value" title="The “draw-value” property"><span class="type">“draw-value”</span></a> property is <code class="literal">FALSE</code>, the return
values are undefined.</p>
<div class="refsect3">
<a name="gtk-scale-get-layout-offsets.parameters"></a><h4>Parameters</h4>
@ -754,12 +754,12 @@ values are undefined.</p>
</tr>
<tr>
<td class="parameter_name"><p>x</p></td>
<td class="parameter_description"><p> location to store X offset of layout, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>location to store X offset of layout, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>y</p></td>
<td class="parameter_description"><p> location to store Y offset of layout, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>location to store Y offset of layout, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
@ -772,16 +772,16 @@ values are undefined.</p>
<a name="gtk-scale-add-mark"></a><h3>gtk_scale_add_mark ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_scale_add_mark (<em class="parameter"><code><a class="link" href="GtkScale.html" title="GtkScale"><span class="type">GtkScale</span></a> *scale</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> value</code></em>,
<em class="parameter"><code><span class="type">gdouble</span> value</code></em>,
<em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkPositionType" title="enum GtkPositionType"><span class="type">GtkPositionType</span></a> position</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *markup</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *markup</code></em>);</pre>
<p>Adds a mark at <em class="parameter"><code>value</code></em>
.</p>
<p>A mark is indicated visually by drawing a tick mark next to the scale,
and GTK+ makes it easy for the user to position the scale exactly at the
marks value.</p>
<p>If <em class="parameter"><code>markup</code></em>
is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, text is shown next to the tick mark.</p>
is not <code class="literal">NULL</code>, text is shown next to the tick mark.</p>
<p>To remove marks from a scale, use <a class="link" href="GtkScale.html#gtk-scale-clear-marks" title="gtk_scale_clear_marks ()"><code class="function">gtk_scale_clear_marks()</code></a>.</p>
<div class="refsect3">
<a name="gtk-scale-add-mark.parameters"></a><h4>Parameters</h4>
@ -813,7 +813,7 @@ the left of the scale, anything else to the right.</p></td>
</tr>
<tr>
<td class="parameter_name"><p>markup</p></td>
<td class="parameter_description"><p> Text to be shown at the mark, using Pango markup, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>Text to be shown at the mark, using Pango markup, or <code class="literal">NULL</code>. </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>
</tbody>
@ -856,7 +856,7 @@ gtk_scale_clear_marks (<em class="parameter"><code><a class="link" href="GtkScal
<a name="GtkScale.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="GtkScale--digits"></a><h3>The <code class="literal">“digits”</code> property</h3>
<pre class="programlisting"> “digits” <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
<pre class="programlisting"> “digits” <span class="type">gint</span></pre>
<p>The number of decimal places that are displayed in the value.</p>
<p>Flags: Read / Write</p>
<p>Allowed values: [-1,64]</p>
@ -865,7 +865,7 @@ gtk_scale_clear_marks (<em class="parameter"><code><a class="link" href="GtkScal
<hr>
<div class="refsect2">
<a name="GtkScale--draw-value"></a><h3>The <code class="literal">“draw-value”</code> property</h3>
<pre class="programlisting"> “draw-value” <a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
<pre class="programlisting"> “draw-value” <span class="type">gboolean</span></pre>
<p>Whether the current value is displayed as a string next to the slider.</p>
<p>Flags: Read / Write</p>
<p>Default value: TRUE</p>
@ -873,7 +873,7 @@ gtk_scale_clear_marks (<em class="parameter"><code><a class="link" href="GtkScal
<hr>
<div class="refsect2">
<a name="GtkScale--has-origin"></a><h3>The <code class="literal">“has-origin”</code> property</h3>
<pre class="programlisting"> “has-origin” <a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
<pre class="programlisting"> “has-origin” <span class="type">gboolean</span></pre>
<p>Whether the scale has an origin.</p>
<p>Flags: Read / Write</p>
<p>Default value: TRUE</p>
@ -891,7 +891,7 @@ gtk_scale_clear_marks (<em class="parameter"><code><a class="link" href="GtkScal
<a name="GtkScale.style-property-details"></a><h2>Style Property Details</h2>
<div class="refsect2">
<a name="GtkScale--s-slider-length"></a><h3>The <code class="literal">“slider-length”</code> style property</h3>
<pre class="programlisting"> “slider-length” <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
<pre class="programlisting"> “slider-length” <span class="type">gint</span></pre>
<p>Length of scale's slider.</p>
<div class="warning">
<p><code class="literal">GtkScale:slider-length</code> has been deprecated since version 3.20 and should not be used in newly-written code.</p>
@ -905,7 +905,7 @@ gtk_scale_clear_marks (<em class="parameter"><code><a class="link" href="GtkScal
<hr>
<div class="refsect2">
<a name="GtkScale--s-value-spacing"></a><h3>The <code class="literal">“value-spacing”</code> style property</h3>
<pre class="programlisting"> “value-spacing” <a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
<pre class="programlisting"> “value-spacing” <span class="type">gint</span></pre>
<p>Space between value text and the slider/trough area.</p>
<div class="warning">
<p><code class="literal">GtkScale:value-spacing</code> has been deprecated since version 3.20 and should not be used in newly-written code.</p>
@ -921,10 +921,10 @@ gtk_scale_clear_marks (<em class="parameter"><code><a class="link" href="GtkScal
<a name="GtkScale.signal-details"></a><h2>Signal Details</h2>
<div class="refsect2">
<a name="GtkScale-format-value"></a><h3>The <code class="literal">“format-value”</code> signal</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>*
<pre class="programlisting"><span class="returnvalue">gchar</span>*
user_function (<a class="link" href="GtkScale.html" title="GtkScale"><span class="type">GtkScale</span></a> *scale,
<a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> value,
<a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<span class="type">gdouble</span> value,
<span class="type">gpointer</span> user_data)</pre>
<p>Signal which allows you to change how the scale value is displayed.
Connect a signal handler which returns an allocated string representing
@ -945,13 +945,13 @@ with "--&gt;1.0&lt;--".</p>
5
6
7</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">static</span> gchar<span class="gtkdoc opt">*</span>
<span class="function">format_value_callback</span> <span class="gtkdoc opt">(</span>GtkScale <span class="gtkdoc opt">*</span>scale<span class="gtkdoc opt">,</span>
gdouble value<span class="gtkdoc opt">)</span>
<span class="gtkdoc opt">{</span>
<span class="keyword">return</span> <span class="function"><a href="../glib/glib-String-Utility-Functions.html#g-strdup-printf">g_strdup_printf</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;--&gt;\%0.*g&lt;--&quot;</span><span class="gtkdoc opt">,</span>
<span class="function"><a href="GtkScale.html#gtk-scale-get-digits">gtk_scale_get_digits</a></span> <span class="gtkdoc opt">(</span>scale<span class="gtkdoc opt">),</span> value<span class="gtkdoc opt">);</span>
<span class="gtkdoc opt">}</span></pre></td>
<td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> gchar</span><span class="symbol">*</span>
<span class="function">format_value_callback</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GtkScale</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">scale</span><span class="symbol">,</span>
<span class="normal"> </span><span class="usertype">gdouble</span><span class="normal"> value</span><span class="symbol">)</span>
<span class="cbracket">{</span>
<span class="normal"> </span><span class="keyword">return</span><span class="normal"> </span><span class="function">g_strdup_printf</span><span class="normal"> </span><span class="symbol">(</span><span class="string">"--&gt;</span><span class="specialchar">\%</span><span class="string">0.*g&lt;--"</span><span class="symbol">,</span>
<span class="normal"> </span><span class="function"><a href="GtkScale.html#gtk-scale-get-digits">gtk_scale_get_digits</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">scale</span><span class="symbol">),</span><span class="normal"> value</span><span class="symbol">);</span>
<span class="normal"> </span><span class="cbracket">}</span></pre></td>
</tr>
</tbody>
</table>
@ -990,11 +990,11 @@ with "--&gt;1.0&lt;--".</p>
<p> allocated string representing <em class="parameter"><code>value</code></em>
</p>
</div>
<p>Flags: <a href="../gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
<p>Flags: Run Last</p>
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.25.1</div>
<hr>Generated by GTK-Doc V1.27</div>
</body>
</html>