gtkscale.html

最新gtk中文资料集

<td>a <a class="link" href="GtkScale.html" title="GtkScale"><span class="type">GtkScale</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>pos</code></em>&#160;:</span></p></td>
<td>the position in which the current value is displayed.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4303783"></a><h3>
<a name="gtk-scale-get-digits"></a>gtk_scale_get_digits ()</h3>
<a class="indexterm" name="id4303796"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                gtk_scale_get_digits                (<a class="link" href="GtkScale.html" title="GtkScale">GtkScale</a> *scale);</pre>
<p>
Gets the number of decimal places that are displayed in the value.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>scale</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="GtkScale.html" title="GtkScale"><span class="type">GtkScale</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>the number of decimal places that are displayed.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4303863"></a><h3>
<a name="gtk-scale-get-draw-value"></a>gtk_scale_get_draw_value ()</h3>
<a class="indexterm" name="id4303876"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_scale_get_draw_value            (<a class="link" href="GtkScale.html" title="GtkScale">GtkScale</a> *scale);</pre>
<p>
Returns whether the current value is displayed as a string next to the
slider.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>scale</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="GtkScale.html" title="GtkScale"><span class="type">GtkScale</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>whether the current value is displayed as a string.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4303942"></a><h3>
<a name="gtk-scale-get-value-pos"></a>gtk_scale_get_value_pos ()</h3>
<a class="indexterm" name="id4303956"></a><pre class="programlisting"><a class="link" href="gtk-Standard-Enumerations.html#GtkPositionType">GtkPositionType</a>     gtk_scale_get_value_pos             (<a class="link" href="GtkScale.html" title="GtkScale">GtkScale</a> *scale);</pre>
<p>
Gets the position in which the current value is displayed.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>scale</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="GtkScale.html" title="GtkScale"><span class="type">GtkScale</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>the position in which the current value is displayed.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4304022"></a><h3>
<a name="gtk-scale-get-layout"></a>gtk_scale_get_layout ()</h3>
<a class="indexterm" name="id4304037"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"
>PangoLayout</a>*        gtk_scale_get_layout                (<a class="link" href="GtkScale.html" title="GtkScale">GtkScale</a> *scale);</pre>
<p>
Gets the <a
href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"
><span class="type">PangoLayout</span></a> used to display the scale. 
The returned object is owned by the scale so does 
not need to be freed by the caller.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>scale</code></em>&#160;:</span></p></td>
<td> A <a class="link" href="GtkScale.html" title="GtkScale"><span class="type">GtkScale</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the <a
href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"
><span class="type">PangoLayout</span></a> for this scale, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> 
   if the <a class="link" href="GtkScale.html#GtkScale--draw-value"><span class="type">"draw-value"</span></a> property is <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a>.
  
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4304160"></a><h3>
<a name="gtk-scale-get-layout-offsets"></a>gtk_scale_get_layout_offsets ()</h3>
<a class="indexterm" name="id4304175"></a><pre class="programlisting">void                gtk_scale_get_layout_offsets        (<a class="link" href="GtkScale.html" title="GtkScale">GtkScale</a> *scale,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> *x,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> *y);</pre>
<p>
Obtains the coordinates where the scale will draw the 
<a
href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"
><span class="type">PangoLayout</span></a> representing the text in the scale. Remember
when using the <a
href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"
><span class="type">PangoLayout</span></a> function you need to convert to
and from pixels using <a
href="/usr/share/gtk-doc/html/pango/pango-Glyph-Storage.html#PANGO-PIXELS:CAPS"
><code class="function">PANGO_PIXELS()</code></a> or <a
href="/usr/share/gtk-doc/html/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"><span class="type">"draw-value"</span></a> property is <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a>, the return 
values are undefined.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>scale</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkScale.html" title="GtkScale"><span class="type">GtkScale</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>x</code></em>&#160;:</span></p></td>
<td> location to store X offset of layout, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>y</code></em>&#160;:</span></p></td>
<td> location to store Y offset of layout, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id4304363"></a><h2>Property Details</h2>
<div class="refsect2" lang="en">
<a name="id4304373"></a><h3>
<a name="GtkScale--digits"></a>The <code class="literal">"digits"</code> property</h3>
<a class="indexterm" name="id4304389"></a><pre class="programlisting">  "digits"                   <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                  : Read / Write</pre>
<p>The number of decimal places that are displayed in the value.</p>
<p>Allowed values: [-1,64]</p>
<p>Default value: 1</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4304421"></a><h3>
<a name="GtkScale--draw-value"></a>The <code class="literal">"draw-value"</code> property</h3>
<a class="indexterm" name="id4304438"></a><pre class="programlisting">  "draw-value"               <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write</pre>
<p>Whether the current value is displayed as a string next to the slider.</p>
<p>Default value: TRUE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4304465"></a><h3>
<a name="GtkScale--value-pos"></a>The <code class="literal">"value-pos"</code> property</h3>
<a class="indexterm" name="id4304480"></a><pre class="programlisting">  "value-pos"                <a class="link" href="gtk-Standard-Enumerations.html#GtkPositionType">GtkPositionType</a>       : Read / Write</pre>
<p>The position in which the current value is displayed.</p>
<p>Default value: GTK_POS_TOP</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id4304509"></a><h2>Style Property Details</h2>
<div class="refsect2" lang="en">
<a name="id4304520"></a><h3>
<a name="GtkScale--slider-length"></a>The <code class="literal">"slider-length"</code> style property</h3>
<a class="indexterm" name="id4304537"></a><pre class="programlisting">  "slider-length"            <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                  : Read</pre>
<p>Length of scale's slider.</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 31</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4304567"></a><h3>
<a name="GtkScale--value-spacing"></a>The <code class="literal">"value-spacing"</code> style property</h3>
<a class="indexterm" name="id4304584"></a><pre class="programlisting">  "value-spacing"            <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                  : Read</pre>
<p>Space between value text and the slider/trough area.</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 2</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id4304616"></a><h2>Signal Details</h2>
<div class="refsect2" lang="en">
<a name="id4304626"></a><h3>
<a name="GtkScale-format-value"></a>The <code class="literal">"format-value"</code> signal</h3>
<a class="indexterm" name="id4304643"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*              user_function                      (<a class="link" href="GtkScale.html" title="GtkScale">GtkScale</a> *scale,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
>gdouble</a>   arg1,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>  user_data)      : Run Last</pre>
<p>
Signal which allows you to change how the scale value is displayed.  Connect a
signal handler which returns an allocated string representing <em class="parameter"><code>value</code></em>.
That string will then be used to display the scale's value.
Here's an example signal handler which displays a value 1.0 as
with "--&gt;1.0&lt;--".
</p>
<div class="informalexample"><pre class="programlisting">
static gchar*
format_value_callback (GtkScale *scale,
                       gdouble   value)
{
  return g_strdup_printf ("--&gt;%0.*g&lt;--",
                          gtk_scale_get_digits (scale), value);
}
</pre></div>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>scale</code></em>&#160;:</span></p></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>arg1</code></em>&#160;:</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>allocated string representing <em class="parameter"><code>value</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id4304775"></a><div class="refsect2" lang="en"><a name="id4304776"></a></div>
<hr>
<div class="refsect2" lang="en"><a name="id4304777"></a></div>
</div>
</div>
</body>
</html>