/usr/share/doc/python-gtk2-tutorial/html/sec-UsingAdjustmentsTheEasyWay.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 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>7.2. Using Adjustments the Easy Way</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="ch-Adjustments.html" title="Chapter 7. Adjustments"><link rel="previous" href="ch-Adjustments.html" title="Chapter 7. Adjustments"><link rel="next" href="sec-AdjustmentInternals.html" title="7.3. Adjustment Internals"></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">7.2. Using Adjustments the Easy Way</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch-Adjustments.html">Prev</a> </td><th width="60%" align="center">Chapter 7. Adjustments</th><td width="20%" align="right"> <a accesskey="n" href="sec-AdjustmentInternals.html">Next</a></td></tr></table><hr></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sec-UsingAdjustmentsTheEasyWay"></a>7.2. Using Adjustments the Easy Way</h2></div></div><div></div></div><p>The adjustable widgets can be roughly divided into those which
use and require specific units for these values, and those which treat them
as arbitrary numbers. The group which treats the values as arbitrary numbers
includes the range widgets (scrollbars and scales, the progress bar widget,
and the spin button widget). These widgets are all the widgets which are
typically "adjusted" directly by the user with the mouse or keyboard. They
will treat the lower and upper values of an adjustment as a range within
which the user can manipulate the adjustment's value. By default, they will
only modify the value of an adjustment.</p><p>The other group includes the text widget, the viewport widget,
the compound list widget, and the scrolled window widget. All of these
widgets use pixel values for their adjustments. These are also all widgets
which are typically "adjusted" indirectly using scrollbars. While all
widgets which use adjustments can either create their own adjustments or use
ones you supply, you'll generally want to let this particular category of
widgets create its own adjustments. Usually, they will eventually override
all the values except the value itself in whatever adjustments you give
them, but the results are, in general, undefined (meaning, you'll have to
read the source code to find out, and it may be different from widget to
widget).</p><p>Now, you're probably thinking, since text widgets and viewports
insist on setting everything except the value of their adjustments, while
scrollbars will only touch the adjustment's value, if you share an
adjustment object between a scrollbar and a text widget, manipulating the
scrollbar will automagically adjust the text widget? Of course it will! Just
like this:</p><table border="0" bgcolor="#E0E0E0" width="100%"><tr><td><pre class="programlisting">
# creates its own adjustments
viewport = gtk.Viewport()
# uses the newly-created adjustment for the scrollbar as well
vscrollbar = gtk.VScrollbar(viewport.get_vadjustment())
</pre></td></tr></table></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch-Adjustments.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch-Adjustments.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="sec-AdjustmentInternals.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 7. Adjustments </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 7.3. Adjustment Internals</td></tr></table></div></body></html>
|