1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>gtk.Range</title><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="index.html" title="PyGTK 2.0 Reference Manual"><link rel="up" href="gtk-class-reference.html" title="The gtk Class Reference"><link rel="previous" href="class-gtkradiotoolbutton.html" title="gtk.RadioToolButton"><link rel="next" href="class-gtkrcstyle.html" title="gtk.RcStyle"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">gtk.Range</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-gtkradiotoolbutton.html">Prev</a></td><th width="60%" align="center">The gtk Class Reference</th><td width="20%" align="right"><a accesskey="n" href="class-gtkrcstyle.html">Next</a></td></tr></table><hr></div><div class="refentry" lang="en"><a name="class-gtkrange"></a><div class="titlepage"><div></div><div></div></div><div class="refnamediv"><h2>gtk.Range</h2><p>gtk.Range — a base class for widgets that allow a user to set a value in
a range.</p></div><div class="refsect1" lang="en"><a name="id3488260"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">gtk.Range</span></span>(<span class="ooclass"><span class="classname"><a href="class-gtkwidget.html" title="gtk.Widget">gtk.Widget</a></span></span>):
<code class="methodsynopsis"> def <span class="methodname"><a href="class-gtkrange.html#method-gtkrange--set-update-policy" title="gtk.Range.set_update_policy">set_update_policy</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>policy</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a href="class-gtkrange.html#method-gtkrange--get-update-policy" title="gtk.Range.get_update_policy">get_update_policy</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a href="class-gtkrange.html#method-gtkrange--set-adjustment" title="gtk.Range.set_adjustment">set_adjustment</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>adjustment</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a href="class-gtkrange.html#method-gtkrange--get-adjustment" title="gtk.Range.get_adjustment">get_adjustment</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a href="class-gtkrange.html#method-gtkrange--set-inverted" title="gtk.Range.set_inverted">set_inverted</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>setting</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a href="class-gtkrange.html#method-gtkrange--get-inverted" title="gtk.Range.get_inverted">get_inverted</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a href="class-gtkrange.html#method-gtkrange--set-increments" title="gtk.Range.set_increments">set_increments</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>step</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>page</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a href="class-gtkrange.html#method-gtkrange--set-range" title="gtk.Range.set_range">set_range</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>min</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>max</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a href="class-gtkrange.html#method-gtkrange--set-value" title="gtk.Range.set_value">set_value</a></span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>value</tt></b></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a href="class-gtkrange.html#method-gtkrange--get-value" title="gtk.Range.get_value">get_value</a></span>(<span class="methodparam"></span>)</code><br></pre></td></tr></table></div><div class="refsect1" lang="en"><a name="id3488488"></a><h2>Ancestry</h2><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="synopsis">+-- <a href="class-gobject.html" title="gobject.GObject">gobject.GObject</a>
+-- <a href="class-gtkobject.html" title="gtk.Object">gtk.Object</a>
+-- <a href="class-gtkwidget.html" title="gtk.Widget">gtk.Widget</a>
+-- <a href="class-gtkrange.html" title="gtk.Range">gtk.Range</a>
</pre></td></tr></table></div><div class="refsect1" lang="en"><a name="id3488523"></a><h2>Properties</h2><div class="blockquote"><table width="100%" border="0" bgcolor="#E0E0E0"><tr><td valign="top"><div class="informaltable"><table width="100%" border="0"><colgroup><col><col><col></colgroup><tbody><tr valign="top"><td valign="top">"adjustment"</td><td valign="top">Read-Write</td><td valign="top">The <a href="class-gtkadjustment.html" title="gtk.Adjustment"><tt class="classname">gtk.Adjustment</tt></a>
that contains the current value of this range object</td></tr><tr valign="top"><td valign="top">"inverted"</td><td valign="top">Read-Write</td><td valign="top">If <tt class="literal">TRUE</tt>, the slider movement is
reversed e.g right-to-left instead of left-to-right</td></tr><tr valign="top"><td valign="top">"update-policy"</td><td valign="top">Read-Write</td><td valign="top">How the range should be updated on the screen:
<tt class="literal">gtk.UPDATE_CONTINUOUS</tt>,
<tt class="literal">gtk.UPDATE_DISCONTINUOUS</tt>,
<tt class="literal">gtk.UPDATE_DELAYED</tt>.</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" lang="en"><a name="id3488653"></a><h2>Style Properties</h2><div class="blockquote"><table width="100%" border="0" bgcolor="#E0E0E0"><tr><td valign="top"><div class="informaltable"><table width="100%" border="0"><colgroup><col><col><col></colgroup><tbody><tr valign="top"><td valign="top">"arrow-displacement-x"</td><td valign="top">Read</td><td valign="top">The distance horizontally to move the arrow when the
button is depressed</td></tr><tr valign="top"><td valign="top">"arrow-displacement-y"</td><td valign="top">Read</td><td valign="top">The distance vertically to move the arrow when the
button is depressed</td></tr><tr valign="top"><td valign="top">"slider-width"</td><td valign="top">Read</td><td valign="top">The width of scrollbar or scale thumb</td></tr><tr valign="top"><td valign="top">"stepper-size"</td><td valign="top">Read</td><td valign="top">The length of step buttons at ends</td></tr><tr valign="top"><td valign="top">"stepper-spacing"</td><td valign="top">Read</td><td valign="top">The spacing between step buttons and thumb</td></tr><tr valign="top"><td valign="top">"trough-border"</td><td valign="top">Read</td><td valign="top">The spacing between thumb or steppers and outer trough
bevel</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" lang="en"><a name="id3488814"></a><h2>Signal Prototypes</h2><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term">"<a href="class-gtkrange.html#signal-gtkrange--adjust-bounds" title='The "adjust-bounds" gtk.Range Signal'>adjust-bounds</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>range</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>value</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr><tr><td><span class="term">"<a href="class-gtkrange.html#signal-gtkrange--move-slider" title='The "move-slider" gtk.Range Signal'>move-slider</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>range</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>scrolltype</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr><tr><td><span class="term">"<a href="class-gtkrange.html#signal-gtkrange--value-changed" title='The "value-changed" gtk.Range Signal'>value-changed</a>"</span></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>range</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></td></tr></tbody></table></div><div class="refsect1" lang="en"><a name="id3488958"></a><h2>Description</h2><p>The <a href="class-gtkrange.html" title="gtk.Range"><tt class="classname">gtk.Range</tt></a> is the base
class for the <a href="class-gtkscale.html" title="gtk.Scale"><tt class="classname">gtk.Scale</tt></a> and <a href="class-gtkscrollbar.html" title="gtk.Scrollbar"><tt class="classname">gtk.Scrollbar</tt></a>
widgets. The <a href="class-gtkrange.html" title="gtk.Range"><tt class="classname">gtk.Range</tt></a> provides
the common functionality for these widgets that allow a user to set a value
in a range of values. The <a href="class-gtkscale.html" title="gtk.Scale"><tt class="classname">gtk.Scale</tt></a> works in
conjunction with a <a href="class-gtkadjustment.html" title="gtk.Adjustment"><tt class="classname">gtk.Adjustment</tt></a>
which provides the range information.</p></div><div class="refsect1" lang="en"><a name="id3489016"></a><h2>Methods</h2><div class="refsect2" lang="en"><a name="method-gtkrange--set-update-policy"></a><h3>gtk.Range.set_update_policy</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_update_policy</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>policy</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>policy</tt></b>:</span></td><td>the update policy:
<tt class="literal">gtk.UPDATE_CONTINUOUS</tt>,
<tt class="literal">gtk.UPDATE_DISCONTINUOUS</tt>,
<tt class="literal">gtk.UPDATE_DELAYED</tt></td></tr></tbody></table><p>The <tt class="methodname">set_update_policy</tt>() method sets the
"update-policy" property to the value specified by
<i class="parameter"><tt>policy</tt></i>. The update policy has the following values
and effects:</p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><tt class="literal">gtk.UPDATE_CONTINUOUS</tt></span></td><td>anytime the range slider is moved, the range value will
change and the "value_changed" signal will be emitted.</td></tr><tr><td><span class="term"><tt class="literal">gtk.UPDATE_DELAYED</tt></span></td><td>the value will be updated after a brief timeout where
no slider motion occurs, so value changes are delayed slightly rather than
continuously updated.</td></tr><tr><td><span class="term"><tt class="literal">gtk.UPDATE_DISCONTINUOUS</tt></span></td><td>the value will only be updated when the user releases
the button and ends the slider drag operation.</td></tr></tbody></table><p></p></div><div class="refsect2" lang="en"><a name="method-gtkrange--get-update-policy"></a><h3>gtk.Range.get_update_policy</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_update_policy</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>the current update policy</td></tr></tbody></table><p>The <tt class="methodname">get_update_policy</tt>() method gets the
value of the "update-policy" property. The update policy is one of:
<tt class="literal">gtk.UPDATE_CONTINUOUS</tt>,
<tt class="literal">gtk.UPDATE_DISCONTINUOUS</tt> or
<tt class="literal">gtk.UPDATE_DELAYED</tt>. See the <a href="class-gtkrange.html#method-gtkrange--set-update-policy" title="gtk.Range.set_update_policy"><tt class="methodname">set_update_policy</tt>()</a>
method for details.</p></div><div class="refsect2" lang="en"><a name="method-gtkrange--set-adjustment"></a><h3>gtk.Range.set_adjustment</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_adjustment</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>adjustment</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>adjustment</tt></b>:</span></td><td>a <a href="class-gtkadjustment.html" title="gtk.Adjustment"><tt class="classname">gtk.Adjustment</tt></a></td></tr></tbody></table><p>The <tt class="methodname">set_adjustment</tt>() method sets the
"adjustment" property to the value specified by
<i class="parameter"><tt>adjustment</tt></i>. The <a href="class-gtkadjustment.html" title="gtk.Adjustment"><tt class="classname">gtk.Adjustment</tt></a>
is used as the "model" object for this range widget.
<i class="parameter"><tt>adjustment</tt></i> indicates the current range value, the
minimum and maximum range values, the step and page increments used for
keybindings and scrolling, and the page size. The page size is normally 0
for <a href="class-gtkscale.html" title="gtk.Scale"><tt class="classname">gtk.Scale</tt></a>
and nonzero for <a href="class-gtkscrollbar.html" title="gtk.Scrollbar"><tt class="classname">gtk.Scrollbar</tt></a>,
and indicates the size of the visible area of the widget being scrolled. The
page size affects the size of the scrollbar slider.</p></div><div class="refsect2" lang="en"><a name="method-gtkrange--get-adjustment"></a><h3>gtk.Range.get_adjustment</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_adjustment</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>a <a href="class-gtkadjustment.html" title="gtk.Adjustment"><tt class="classname">gtk.Adjustment</tt></a></td></tr></tbody></table><p>The <tt class="methodname">get_adjustment</tt>() method returns the
value of the "adjustment" property. See the <a href="class-gtkrange.html#method-gtkrange--set-adjustment" title="gtk.Range.set_adjustment"><tt class="methodname">set_adjustment</tt>()</a>
method for details.</p></div><div class="refsect2" lang="en"><a name="method-gtkrange--set-inverted"></a><h3>gtk.Range.set_inverted</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_inverted</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>setting</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>setting</tt></b>:</span></td><td>if <tt class="literal">TRUE</tt> invert the
range</td></tr></tbody></table><p>The <tt class="methodname">set_inverted</tt>() method sets the
"inverted" property to the value specified by
<i class="parameter"><tt>setting</tt></i>. If <i class="parameter"><tt>setting</tt></i> is
<tt class="literal">TRUE</tt> the normal motion of the range widget is reversed.
Ranges normally move from lower to higher values as the slider moves from
top to bottom or left to right. Inverted ranges have higher values at the
top or left rather than on the bottom or right.</p></div><div class="refsect2" lang="en"><a name="method-gtkrange--get-inverted"></a><h3>gtk.Range.get_inverted</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_inverted</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td><tt class="literal">TRUE</tt> if the range is
inverted</td></tr></tbody></table><p>The <tt class="methodname">get_inverted</tt>() method returns the
value of the "inverted" property that was set by the <a href="class-gtkrange.html#method-gtkrange--set-inverted" title="gtk.Range.set_inverted"><tt class="methodname">set_inverted</tt>()</a>
method.</p></div><div class="refsect2" lang="en"><a name="method-gtkrange--set-increments"></a><h3>gtk.Range.set_increments</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_increments</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>step</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>page</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>step</tt></b>:</span></td><td>the step size</td></tr><tr><td><span class="term"><b class="parameter"><tt>page</tt></b>:</span></td><td>the page size</td></tr></tbody></table><p>The <tt class="methodname">set_increments</tt>() method sets the
step and page sizes for the range to the values specified by
<i class="parameter"><tt>step</tt></i> and <i class="parameter"><tt>page</tt></i> respectively.
The step size is used when the user clicks the <a href="class-gtkscrollbar.html" title="gtk.Scrollbar"><tt class="classname">gtk.Scrollbar</tt></a>
arrows or moves <a href="class-gtkscale.html" title="gtk.Scale"><tt class="classname">gtk.Scale</tt></a> via the
arrow keys. The page size is used for example when moving via <span><b class="keycap">Page
Up</b></span> or <span><b class="keycap">Page Down</b></span> keys.</p></div><div class="refsect2" lang="en"><a name="method-gtkrange--set-range"></a><h3>gtk.Range.set_range</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_range</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>min</tt></b></span></span>, <span class="methodparam"><span class="parameter"><b class="parameter"><tt>max</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>min</tt></b>:</span></td><td>the minimum range value</td></tr><tr><td><span class="term"><b class="parameter"><tt>max</tt></b>:</span></td><td>the maximum range value</td></tr></tbody></table><p>The <tt class="methodname">set_range</tt>() method sets the minimum
and maximum allowable values for the <a href="class-gtkrange.html" title="gtk.Range"><tt class="classname">gtk.Range</tt></a> to that
values specified by <i class="parameter"><tt>min</tt></i> and
<i class="parameter"><tt>max</tt></i> respectively. If the range has a non-zero page
size, it is also forced to be between <i class="parameter"><tt>min</tt></i> and
<i class="parameter"><tt>max</tt></i>.</p></div><div class="refsect2" lang="en"><a name="method-gtkrange--set-value"></a><h3>gtk.Range.set_value</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_value</span>(<span class="methodparam"><span class="parameter"><b class="parameter"><tt>value</tt></b></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><b class="parameter"><tt>value</tt></b>:</span></td><td>the new value of the range</td></tr></tbody></table><p>The <tt class="methodname">set_value</tt>() method sets the current
value of the range to the value specified by <i class="parameter"><tt>value</tt></i>.
<i class="parameter"><tt>value</tt></i> will be forced inside the minimum or maximum
range values. The range emits the "value_changed" signal if the value
changes.</p></div><div class="refsect2" lang="en"><a name="method-gtkrange--get-value"></a><h3>gtk.Range.get_value</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_value</span>(<span class="methodparam"></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>:</span></td><td>the current value of the
range.</td></tr></tbody></table><p>The <tt class="methodname">get_value</tt>() method gets the current
value of the range.</p></div></div><div class="refsect1" lang="en"><a name="id3489890"></a><h2>Signals</h2><div class="refsect2" lang="en"><a name="signal-gtkrange--adjust-bounds"></a><h3>The "adjust-bounds" gtk.Range Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>range</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>value</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>range</tt></i>:</span></td><td>the range that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>value</tt></i>:</span></td><td>the value</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "adjust-bounds" signal is emitted when the range is adjusted
by user action. Note the value can be more or less than the range since it
depends on the mouse position.</p></div><div class="refsect2" lang="en"><a name="signal-gtkrange--move-slider"></a><h3>The "move-slider" gtk.Range Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>range</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>scrolltype</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>range</tt></i>:</span></td><td>the range that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>scrolltype</tt></i>:</span></td><td>the scroll type issued because a key was
pressed by the user; one of: <tt class="literal">gtk.SCROLL_NONE</tt>,
<tt class="literal">gtk.SCROLL_JUMP</tt>,
<tt class="literal">gtk.SCROLL_STEP_BACKWARD</tt>,
<tt class="literal">gtk.SCROLL_STEP_FORWARD</tt>,
<tt class="literal">gtk.SCROLL_PAGE_BACKWARD</tt>,
<tt class="literal">gtk.SCROLL_PAGE_FORWARD</tt>,
<tt class="literal">gtk.SCROLL_STEP_UP</tt>,
<tt class="literal">gtk.SCROLL_STEP_DOWN</tt>,
<tt class="literal">gtk.SCROLL_PAGE_UP</tt>,
<tt class="literal">gtk.SCROLL_PAGE_DOWN</tt>,
<tt class="literal">gtk.SCROLL_STEP_LEFT</tt>,
<tt class="literal">gtk.SCROLL_STEP_RIGHT</tt>,
<tt class="literal">gtk.SCROLL_PAGE_LEFT</tt>,
<tt class="literal">gtk.SCROLL_PAGE_RIGHT</tt>,
<tt class="literal">gtk.SCROLL_START</tt> or
<tt class="literal">gtk.SCROLL_END</tt></td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "move-slider" signal is emitted when the user presses a key
(e.g. <span><b class="keycap">Page Up</b></span>, <span><b class="keycap">Home</b></span>, <span><b class="keycap">Right
Arrow</b></span>) to move the slider.</p></div><div class="refsect2" lang="en"><a name="signal-gtkrange--value-changed"></a><h3>The "value-changed" gtk.Range Signal</h3><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><i class="parameter"><tt>range</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>user_param1</tt></i></span></span>, <span class="methodparam"><span class="parameter"><i class="parameter"><tt>...</tt></i></span></span>)</code></pre></td></tr></table><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><span class="term"><i class="parameter"><tt>range</tt></i>:</span></td><td>the range that received the
signal</td></tr><tr><td><span class="term"><i class="parameter"><tt>user_param1</tt></i>:</span></td><td>the first user parameter (if any) specified
with the <a href="class-gobject.html#method-gobject--connect" title="gobject.GObject.connect"><tt class="methodname">connect</tt>()</a>
method</td></tr><tr><td><span class="term"><i class="parameter"><tt>...</tt></i>:</span></td><td>additional user parameters (if
any)</td></tr></tbody></table><p>The "value-changed" signal is emitted when the range value is
changed either programmatically or by user action.</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="class-gtkradiotoolbutton.html">Prev</a></td><td width="20%" align="center"><a accesskey="u" href="gtk-class-reference.html">Up</a></td><td width="40%" align="right"><a accesskey="n" href="class-gtkrcstyle.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">gtk.RadioToolButton</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">gtk.RcStyle</td></tr></table></div></body></html>
|
