/usr/share/doc/python-gtk2-tutorial/html/ch-RangeWidgets.html is in python-gtk2-tutorial 2.4-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 8. Range Widgets</title><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="index.html" title="PyGTK 2.0 Tutorial"><link rel="up" href="index.html" title="PyGTK 2.0 Tutorial"><link rel="previous" href="sec-AdjustmentInternals.html" title="7.3. Adjustment Internals"><link rel="next" href="sec-ScaleWidgets.html" title="8.2. Scale Widgets"></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">Chapter 8. Range Widgets</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="sec-AdjustmentInternals.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="sec-ScaleWidgets.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="ch-RangeWidgets"></a>Chapter 8. Range Widgets</h2></div></div><div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="ch-RangeWidgets.html#sec-ScrollbarWidgets">8.1. Scrollbar Widgets</a></span></dt><dt><span class="sect1"><a href="sec-ScaleWidgets.html">8.2. Scale Widgets</a></span></dt><dd><dl><dt><span class="sect2"><a href="sec-ScaleWidgets.html#id3049331">8.2.1. Creating a Scale Widget</a></span></dt><dt><span class="sect2"><a href="sec-ScaleWidgets.html#id3049384">8.2.2. Methods and Signals (well, methods, at least)</a></span></dt></dl></dd><dt><span class="sect1"><a href="sec-CommonRangeMethods.html">8.3. Common Range Methods</a></span></dt><dd><dl><dt><span class="sect2"><a href="sec-CommonRangeMethods.html#id3060169">8.3.1. Setting the Update Policy</a></span></dt><dt><span class="sect2"><a href="sec-CommonRangeMethods.html#id3060239">8.3.2. Getting and Setting Adjustments</a></span></dt></dl></dd><dt><span class="sect1"><a href="sec-KeyAndMouseBindings.html">8.4. Key and Mouse Bindings</a></span></dt><dt><span class="sect1"><a href="sec-RangeWidgetEample.html">8.5. Range Widget Example</a></span></dt></dl></div><p>The category of range widgets includes the ubiquitous scrollbar
widget and the less common "scale" widget. Though these two types of widgets
are generally used for different purposes, they are quite similar in
function and implementation. All range widgets share a set of common graphic
elements, each of which has its own X window and receives events. They all
contain a "trough" and a "slider" (what is sometimes called a "thumbwheel"
in other GUI environments). Dragging the slider with the pointer moves it
back and forth within the trough, while clicking in the trough advances the
slider towards the location of the click, either completely, or by a
designated amount, depending on which mouse button is used.</p><p>As mentioned in <a href="ch-Adjustments.html" title="Chapter 7. Adjustments">Chapter 7, <i>Adjustments</i></a> above, all
range widgets are associated with an <tt class="classname">Adjustment</tt>
object, from which they calculate the length of the slider and its position
within the trough. When the user manipulates the slider, the range widget
will change the value of the adjustment.</p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sec-ScrollbarWidgets"></a>8.1. Scrollbar Widgets</h2></div></div><div></div></div><p>These are your standard, run-of-the-mill scrollbars. These
should be used only for scrolling some other widget, such as a list, a text
box, or a viewport (and it's generally easier to use the scrolled window
widget in most cases). For other purposes, you should use scale widgets, as
they are friendlier and more featureful.</p><p>There are separate types for horizontal and vertical scrollbars.
There really isn't much to say about these. You create them with the
following methods:</p><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting">
hscrollbar = gtk.HSscrollbar(<b class="parameter"><tt>adjustment</tt></b>=None)
vscrollbar = gtk.VSscrollbar(<b class="parameter"><tt>adjustment</tt></b>=None)
</pre></td></tr></table><p>and that's about it. The <i class="parameter"><tt>adjustment</tt></i>
argument can either be a reference to an existing
<tt class="classname">Adjustment</tt> (see <a href="ch-Adjustments.html" title="Chapter 7. Adjustments">Chapter 7, <i>Adjustments</i></a>), or nothing, in which case one will be
created for you. Specifying nothing might be useful in the case, where you
wish to pass the newly-created adjustment to the constructor function of
some other widget which will configure it for you, such as a text
widget.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="sec-AdjustmentInternals.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="index.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="sec-ScaleWidgets.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">7.3. Adjustment Internals </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 8.2. Scale Widgets</td></tr></table></div></body></html>
|