1 line
1.7 KiB
HTML
1 line
1.7 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
|
|
<html>
|
|
<head>
|
|
<title>PyGUI - Terminology</title>
|
|
|
|
<meta name="GENERATOR"
|
|
content="Mozilla/3.01Gold (X11; I; SunOS 5.5 sun4u) [Netscape]">
|
|
</head>
|
|
<body>
|
|
|
|
<h1>Terminology used in PyGUI</h1>
|
|
|
|
<h2>Properties</h2>
|
|
The term <i>property </i>has a special meaning in the PyGUI documentation.
|
|
It refers to an attribute having the following special characteristics:<br>
|
|
|
|
<ul>
|
|
<li>Access to the property is mediated by a pair of accessor methods.
|
|
Reading a property called <tt>foo</tt> is implemented by a method called
|
|
<tt>get_foo</tt>, and assigning to it is implemented by a method called
|
|
<tt>set_foo</tt>. These methods may be overridden in subclasses.</li>
|
|
|
|
</ul>
|
|
|
|
<ul>
|
|
<li>An initial value for the property may be supplied in the form of a
|
|
keyword argument to the class's constructor. These keyword arguments will
|
|
not normally be listed explicitly in the documentation for the constructor,
|
|
but you can assume that the names of all the (non-readonly) properties of
|
|
the class and its superclasses are also acceptable as keyword arguments to
|
|
its constructor.</li>
|
|
|
|
</ul>
|
|
|
|
<ul>
|
|
<li>Classes which support properties have a <tt>set()</tt> method which
|
|
accepts property names as keyword arguments. This can provide a convenient
|
|
way of setting the values of multiple properties at once.<br>
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<p>Some properties are <i>read-only</i>, meaning that they cannot be assigned
|
|
to or given initial values in the constructor. Some are <i>initialize-only</i>,
|
|
meaning that they can be given initial values in the constructor but not changed
|
|
after that. The documentation for each property will make it clear when either
|
|
of these conditions applies.<br>
|
|
</p>
|
|
<br>
|
|
</body>
|
|
</html>
|