gtkrange.html

最新gtk中文资料集

<hr>
<div class="refsect2" lang="en">
<a name="id4297135"></a><h3>
<a name="GtkRange--slider-width"></a>The <code class="literal">"slider-width"</code> style property</h3>
<a class="indexterm" name="id4297152"></a><pre class="programlisting">  "slider-width"             <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                  : Read</pre>
<p>Width of scrollbar or scale thumb.</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 14</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4297182"></a><h3>
<a name="GtkRange--stepper-size"></a>The <code class="literal">"stepper-size"</code> style property</h3>
<a class="indexterm" name="id4297199"></a><pre class="programlisting">  "stepper-size"             <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                  : Read</pre>
<p>Length of step buttons at ends.</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 14</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4297230"></a><h3>
<a name="GtkRange--stepper-spacing"></a>The <code class="literal">"stepper-spacing"</code> style property</h3>
<a class="indexterm" name="id4297246"></a><pre class="programlisting">  "stepper-spacing"          <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                  : Read</pre>
<p>
The spacing between the stepper buttons and thumb. Note that
setting this value to anything &gt; 0 will automatically set the
trough-under-steppers style property to <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> as well. Also,
stepper-spacing won't have any effect if there are no steppers.</p>
<p>

</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 0</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4297294"></a><h3>
<a name="GtkRange--trough-border"></a>The <code class="literal">"trough-border"</code> style property</h3>
<a class="indexterm" name="id4297311"></a><pre class="programlisting">  "trough-border"            <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                  : Read</pre>
<p>Spacing between thumb/steppers and outer trough bevel.</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 1</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4297342"></a><h3>
<a name="GtkRange--trough-side-details"></a>The <code class="literal">"trough-side-details"</code> style property</h3>
<a class="indexterm" name="id4297359"></a><pre class="programlisting">  "trough-side-details"      <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read</pre>
<p>
When <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>, the parts of the trough on the two sides of the 
slider are drawn with different details.</p>
<p>

</p>
<p>Default value: FALSE</p>
<p>Since  2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4297406"></a><h3>
<a name="GtkRange--trough-under-steppers"></a>The <code class="literal">"trough-under-steppers"</code> style property</h3>
<a class="indexterm" name="id4297424"></a><pre class="programlisting">  "trough-under-steppers"    <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read</pre>
<p>
Whether to draw the trough across the full length of the range or
to exclude the steppers and their spacing. Note that setting the
<a class="link" href="GtkRange.html#GtkRange--stepper-spacing"><span class="type">"stepper-spacing"</span></a> style property to any value &gt; 0 will
automatically enable trough-under-steppers too.</p>
<p>

</p>
<p>Default value: TRUE</p>
<p>Since  2.10
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id4297475"></a><h2>Signal Details</h2>
<div class="refsect2" lang="en">
<a name="id4297486"></a><h3>
<a name="GtkRange-adjust-bounds"></a>The <code class="literal">"adjust-bounds"</code> signal</h3>
<a class="indexterm" name="id4297502"></a><pre class="programlisting">void                user_function                      (<a class="link" href="GtkRange.html" title="GtkRange">GtkRange</a> *range,
                                                        <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>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>range</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>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4297592"></a><h3>
<a name="GtkRange-change-value"></a>The <code class="literal">"change-value"</code> signal</h3>
<a class="indexterm" name="id4297608"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            user_function                      (<a class="link" href="GtkRange.html" title="GtkRange">GtkRange</a>     *range,
                                                        <a class="link" href="gtk-Standard-Enumerations.html#GtkScrollType">GtkScrollType</a> scroll,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble"
>gdouble</a>       value,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>      user_data)      : Run Last</pre>
<p>
The ::change-value signal is emitted when a scroll action is
performed on a range.  It allows an application to determine the
type of scroll event that occurred and the resultant new value.
The application can handle the event itself and return <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> to
prevent further processing.  Or, by returning <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a>, it can pass
the event to other handlers until the default GTK+ handler is
reached.
</p>
<p>
The value parameter is unrounded.  An application that overrides
the ::change-value signal is responsible for clamping the value to
the desired number of decimal digits; the default GTK+ handler 
clamps the value based on <em class="parameter"><code>range-&gt;round_digits</code></em>.
</p>
<p>
It is not possible to use delayed update policies in an overridden
::change-value handler.</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>range</code></em>&#160;:</span></p></td>
<td> the range that received the signal
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>scroll</code></em>&#160;:</span></p></td>
<td> the type of scroll action that was performed
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></p></td>
<td> the new value resulting from the scroll action
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>returns</code></em>&#160;:</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> to prevent other handlers from being invoked for the
signal, <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> to propagate the signal further
</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>
</tbody>
</table></div>
<p>Since  2.6
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4297809"></a><h3>
<a name="GtkRange-move-slider"></a>The <code class="literal">"move-slider"</code> signal</h3>
<a class="indexterm" name="id4297825"></a><pre class="programlisting">void                user_function                      (<a class="link" href="GtkRange.html" title="GtkRange">GtkRange</a>     *range,
                                                        <a class="link" href="gtk-Standard-Enumerations.html#GtkScrollType">GtkScrollType</a> step,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>      user_data)      : Run Last / Action</pre>
<p>
Virtual function that moves the slider. Used for keybindings.</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>range</code></em>&#160;:</span></p></td>
<td> the <a class="link" href="GtkRange.html" title="GtkRange"><span class="type">GtkRange</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>step</code></em>&#160;:</span></p></td>
<td> how to move the slider
</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>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4297928"></a><h3>
<a name="GtkRange-value-changed"></a>The <code class="literal">"value-changed"</code> signal</h3>
<a class="indexterm" name="id4297944"></a><pre class="programlisting">void                user_function                      (<a class="link" href="GtkRange.html" title="GtkRange">GtkRange</a> *range,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>  user_data)      : Run Last</pre>
<p>
Emitted when the range value changes.</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>range</code></em>&#160;:</span></p></td>
<td> the <a class="link" href="GtkRange.html" title="GtkRange"><span class="type">GtkRange</span></a>
</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>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id4298026"></a><div class="refsect2" lang="en"><a name="id4298027"></a></div>
<hr>
<div class="refsect2" lang="en"><a name="id4298028"></a></div>
</div>
</div>
</body>
</html>