/usr/share/gtk-doc/html/pygtk/class-gtkfixed.html is in python-gtk2-doc 2.24.0-3.
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 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 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>gtk.Fixed</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><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="prev" href="class-gtkfileselection.html" title="gtk.FileSelection"><link rel="next" href="class-gtkfontbutton.html" title="gtk.FontButton"></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.Fixed</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-gtkfileselection.html">Prev</a> </td><th width="60%" align="center">The gtk Class Reference</th><td width="20%" align="right"> <a accesskey="n" href="class-gtkfontbutton.html">Next</a></td></tr></table><hr></div><div class="refentry" title="gtk.Fixed"><a name="class-gtkfixed"></a><div class="titlepage"></div><div class="refnamediv"><h2>gtk.Fixed</h2><p>gtk.Fixed — a container which allows you to position widgets at fixed
coordinates</p></div><div class="refsect1" title="Synopsis"><a name="id3714833"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">gtk.Fixed</span></span>(<span class="ooclass"><span class="classname"><a class="link" href="class-gtkcontainer.html" title="gtk.Container">gtk.Container</a></span></span>):
<code class="constructorsynopsis"> <span class="methodname"><a class="link" href="class-gtkfixed.html#constructor-gtkfixed" title="Constructor">gtk.Fixed</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkfixed.html#method-gtkfixed--put" title="gtk.Fixed.put">put</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>widget</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>y</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkfixed.html#method-gtkfixed--move" title="gtk.Fixed.move">move</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>widget</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>y</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkfixed.html#method-gtkfixed--set-has-window" title="gtk.Fixed.set_has_window">set_has_window</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>has_window</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkfixed.html#method-gtkfixed--get-has-window" title="gtk.Fixed.get_has_window">get_has_window</a></span>(<span class="methodparam"></span>)</code><br></pre></td></tr></table></div><div class="refsect1" title="Ancestry"><a name="id3715040"></a><h2>Ancestry</h2><pre class="synopsis">+-- <PYGTKDOCLINK HREF="class-gobject">gobject.GObject</PYGTKDOCLINK>
+-- <a class="link" href="class-gtkobject.html" title="gtk.Object">gtk.Object</a>
+-- <a class="link" href="class-gtkwidget.html" title="gtk.Widget">gtk.Widget</a>
+-- <a class="link" href="class-gtkcontainer.html" title="gtk.Container">gtk.Container</a>
+-- <a class="link" href="class-gtkfixed.html" title="gtk.Fixed">gtk.Fixed</a>
</pre></div><div class="refsect1" title="Implemented Interfaces"><a name="id3715084"></a><h2>Implemented Interfaces</h2><p>
<a class="link" href="class-gtkfixed.html" title="gtk.Fixed"><code class="classname">gtk.Fixed</code></a>
implements
<a class="link" href="class-gtkbuildable.html" title="gtk.Buildable"><code class="classname">gtk.Buildable</code></a>
</p></div><div class="refsect1" title="gtk.Fixed Properties"><a name="properties-gtkfixed"></a><h2>gtk.Fixed Properties</h2><p><a class="link" href="class-gtkobject.html#properties-gtkobject" title="gtk.Object Properties">gtk.Object Properties</a></p><p><a class="link" href="class-gtkwidget.html#properties-gtkwidget" title="gtk.Widget Properties">gtk.Widget Properties</a></p><p><a class="link" href="class-gtkcontainer.html#properties-gtkcontainer" title="gtk.Container Properties">gtk.Container Properties</a></p></div><div class="refsect1" title="gtk.Fixed Style Properties"><a name="style-properties-gtkfixed"></a><h2>gtk.Fixed Style Properties</h2><p><a class="link" href="class-gtkwidget.html#style-properties-gtkwidget" title="gtk.Widget Style Properties">gtk.Widget Style Properties</a></p></div><div class="refsect1" title="gtk.Fixed Child Properties"><a name="child-properties-gtkfixed"></a><h2>gtk.Fixed Child 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 width="1in"><col width="1in"><col width="3.5in"></colgroup><tbody><tr valign="top"><td valign="top">"x"</td><td valign="top">Read/Write</td><td valign="top">The x position of the child widget.</td></tr><tr valign="top"><td valign="top">"y"</td><td valign="top">Read/Write</td><td valign="top">The y position of the child widget.</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" title="gtk.Fixed Signal Prototypes"><a name="signal-prototypes-gtkfixed"></a><h2>gtk.Fixed Signal Prototypes</h2><p><PYGTKDOCLINK HREF="signal-prototypes-gobject">gobject.GObject Signal Prototypes</PYGTKDOCLINK></p><p><a class="link" href="class-gtkobject.html#signal-prototypes-gtkobject" title="gtk.Object Signal Prototypes">gtk.Object Signal Prototypes</a></p><p><a class="link" href="class-gtkwidget.html#signal-prototypes-gtkwidget" title="gtk.Widget Signal Prototypes">gtk.Widget Signal Prototypes</a></p><p><a class="link" href="class-gtkcontainer.html#signal-prototypes-gtkcontainer" title="gtk.Container Signal Prototypes">gtk.Container Signal Prototypes</a></p></div><div class="refsect1" title="Description"><a name="id3715298"></a><h2>Description</h2><p>The <a class="link" href="class-gtkfixed.html" title="gtk.Fixed"><code class="classname">gtk.Fixed</code></a> widget is a
container that can place child widgets at fixed positions and with fixed
sizes, given in pixels. <a class="link" href="class-gtkfixed.html" title="gtk.Fixed"><code class="classname">gtk.Fixed</code></a> performs no
automatic layout management. For most applications, you should not use this
container! It keeps you from having to learn about the other PyGTK
containers, but it results in broken applications. With <a class="link" href="class-gtkfixed.html" title="gtk.Fixed"><code class="classname">gtk.Fixed</code></a>, the
following things will result in truncated text, overlapping widgets, and
other display bugs:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Themes, which may change widget sizes.</p></li><li class="listitem"><p>Fonts other than the one you used to write the app will of
course change the size of widgets containing text; keep in mind that users
may use a larger font because of difficulty reading the default, or they may
be using Windows or the framebuffer port of PyGTK, where different fonts are
available.</p></li><li class="listitem"><p>Translation of text into other languages changes its size.
Also, display of non-English text will use a different font in many
cases.</p></li></ul></div><p>In addition, the fixed widget can't properly be mirrored in
right-to-left languages such as Hebrew and Arabic. i.e. normally PyGTK will
flip the interface to put labels to the right of the thing they label, but
it can't do that with <a class="link" href="class-gtkfixed.html" title="gtk.Fixed"><code class="classname">gtk.Fixed</code></a>. So your
application will not be usable in right-to-left languages. Finally, fixed
positioning makes it kind of annoying to add and remove GUI elements, since
you have to reposition all the other elements. This is a long-term
maintenance problem for your application. If you know none of these things
are an issue for your application, and prefer the simplicity of <a class="link" href="class-gtkfixed.html" title="gtk.Fixed"><code class="classname">gtk.Fixed</code></a>, by all
means use the widget. But you should be aware of the tradeoffs.</p></div><div class="refsect1" title="Constructor"><a name="constructor-gtkfixed"></a><h2>Constructor</h2><pre class="programlisting"><code class="constructorsynopsis"> <span class="methodname">gtk.Fixed</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a new fixed widget</td></tr></tbody></table><p>Creates a new <a class="link" href="class-gtkfixed.html" title="gtk.Fixed"><code class="classname">gtk.Fixed</code></a>
widget</p></div><div class="refsect1" title="Methods"><a name="id3715461"></a><h2>Methods</h2><div class="refsect2" title="gtk.Fixed.put"><a name="method-gtkfixed--put"></a><h3>gtk.Fixed.put</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">put</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>widget</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>y</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>widget</code></strong> :</span></p></td><td>the child widget being
added*</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>x</code></strong> :</span></p></td><td>the x position of the widget
location</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>y</code></strong> :</span></p></td><td>the y position of the widget
location</td></tr></tbody></table><p>The <code class="methodname">put</code>() method adds the child widget
specified by <em class="parameter"><code>widget</code></em> to the gtk.Fixed widget at the
location specified by <em class="parameter"><code>x</code></em> and
<em class="parameter"><code>y</code></em>.</p></div><div class="refsect2" title="gtk.Fixed.move"><a name="method-gtkfixed--move"></a><h3>gtk.Fixed.move</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">move</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>widget</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>x</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>y</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>widget</code></strong> :</span></p></td><td>the child widget</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>x</code></strong> :</span></p></td><td>the new x position</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>y</code></strong> :</span></p></td><td>the new y position</td></tr></tbody></table><p>The <code class="methodname">move</code>() method moves the child
widget specified by <em class="parameter"><code>widget</code></em> to the location specified
specified by <em class="parameter"><code>x</code></em> and <em class="parameter"><code>y</code></em>.</p></div><div class="refsect2" title="gtk.Fixed.set_has_window"><a name="method-gtkfixed--set-has-window"></a><h3>gtk.Fixed.set_has_window</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_has_window</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>has_window</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>has_window</code></strong> :</span></p></td><td>if <code class="literal">True</code> a separate window
should be created</td></tr></tbody></table><p>The <code class="methodname">set_has_window</code>() method specifies
whether a <a class="link" href="class-gtkfixed.html" title="gtk.Fixed"><code class="classname">gtk.Fixed</code></a> widget is
created with a separate <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a>
according to the value of <em class="parameter"><code>has_window</code></em>. If
<em class="parameter"><code>has_window</code></em> is <code class="literal">True</code> the fixed
widget will be created with its own separate window. By default, the setting
is <code class="literal">False</code> and the fixed will be created with no separate
<a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a>. This
method must be called while the <a class="link" href="class-gtkfixed.html" title="gtk.Fixed"><code class="classname">gtk.Fixed</code></a> is not
realized, for instance, immediately after the window is created.</p></div><div class="refsect2" title="gtk.Fixed.get_has_window"><a name="method-gtkfixed--get-has-window"></a><h3>gtk.Fixed.get_has_window</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_has_window</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the fixed widget has
its own window.</td></tr></tbody></table><p>The <code class="methodname">get_has_window</code>() method returns
<code class="literal">True</code> if the <a class="link" href="class-gtkfixed.html" title="gtk.Fixed"><code class="classname">gtk.Fixed</code></a> widget has
it's own <a class="link" href="class-gdkwindow.html" title="gtk.gdk.Window"><code class="classname">gtk.gdk.Window</code></a>. See
the <a class="link" href="class-gtkfixed.html#method-gtkfixed--set-has-window" title="gtk.Fixed.set_has_window"><code class="methodname">set_has_window</code>()</a>
method.</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-gtkfileselection.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-gtkfontbutton.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">gtk.FileSelection </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> gtk.FontButton</td></tr></table></div></body></html>
|