diff options
author | tpearson <tpearson@283d02a7-25f6-0310-bc7c-ecb5cbfe19da> | 2010-09-14 19:47:20 +0000 |
---|---|---|
committer | tpearson <tpearson@283d02a7-25f6-0310-bc7c-ecb5cbfe19da> | 2010-09-14 19:47:20 +0000 |
commit | 875ae8e38bc3663e5057ca910e7ebe4b2994edb9 (patch) | |
tree | ddd3b3bc4d6f0343bae986aebbf9555c20f8e558 /python/pykde/doc/static.html | |
parent | cb61a0436524f8ceba31db51ce3f1c5d4afbbb0e (diff) | |
download | tdebindings-875ae8e38bc3663e5057ca910e7ebe4b2994edb9.tar.gz tdebindings-875ae8e38bc3663e5057ca910e7ebe4b2994edb9.zip |
Updated python directory
git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdebindings@1175349 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
Diffstat (limited to 'python/pykde/doc/static.html')
-rw-r--r-- | python/pykde/doc/static.html | 183 |
1 files changed, 0 insertions, 183 deletions
diff --git a/python/pykde/doc/static.html b/python/pykde/doc/static.html deleted file mode 100644 index 0ee4ef76..00000000 --- a/python/pykde/doc/static.html +++ /dev/null @@ -1,183 +0,0 @@ -<HTML> -<HEAD> -<TITLE>Types and Related Topics</TITLE> -</HEAD> -<BODY CLASS="SECT1"> -<DIV CLASS="NAVHEADER"> -<TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0"> -<TR> -<TH COLSPAN="3" ALIGN="center">Python Bindings for KDE (PyKDE-3.16.0)</TH> -</TR> -<TR> -<TD WIDTH="10%" ALIGN="left" VALIGN="bottom"> -<A HREF="signal.html" ACCESSKEY="P">Prev</A> -</TD> -<TD WIDTH="80%" ALIGN="center" VALIGN="bottom"></TD> -<TD WIDTH="10%" ALIGN="right" VALIGN="bottom"> -<A HREF="classref/index.html" ACCESSKEY="N">Next</A> -</TD> -</TR> -</TABLE> -<HR ALIGN="LEFT" WIDTH="100%"> -</DIV> -<H1>Types and Related Topics</H1> -<H2>Static Member Functions</H2> -<P> -Static member functions are implemented as Python class functions. -For example the C++ static member function -<TT CLASS="LITERAL" >TQObject::connect()</TT> -is called from Python as -<TT CLASS="LITERAL">TQObject.connect()</TT> or -<TT CLASS="LITERAL">self.connect()</TT> -if called from a sub-class of -<TT CLASS="LITERAL">TQObject</TT>. -</P> -<h2>None and NULL</h2> -<P>Throughout the bindings, the -<TT CLASS="LITERAL">None</TT> -value can be specified wherever -<TT CLASS="LITERAL">NULL</TT> -is acceptable to the underlying C++ code.</P> -<P >Equally, -<TT CLASS="LITERAL">NULL</TT> -is converted to -<TT CLASS="LITERAL">None</TT> -whenever it is returned by the underlying C++ code -</P> - -<h2>Enumerated Types</H2> -<P> -Enumerated types are implemented as a set of simple variables corresponding to -the separate enumerated values. -</P> -<P> -When using an enumerated value the name of the class (or a sub-class) in which -the enumerated type was defined in must be included. For example: -</P> -<TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%" > -<TR> -<TD> -<PRE CLASS="PROGRAMLISTING"> -Qt.SolidPattern -TQWidget.TabFocus -TQFrame.TabFocus -</PRE> -</TD> -</TR> -</TABLE> - -<H2>Namespaces</H2> -<P> -The C++ code in KDE makes extensive use of namespaces (especially in the kio, kjs, -khtml, kfile, and kparts modules). In PyKDE, namespaces are treated as a "superclass". -For example, "from kparts import KParts" will import the KParts namespace and all -its members. To reference a class in the namespace, use <namespace name>..<classname>, -for example, KParts.ReadOnlyPart. It isn't necessary to import the <classname> (ReadOnlyPart -in the example). -</P> -<h2>Return and Argument Types</h2> -<p> -Some return types or argument types may be different than those in the C++ KDE libs. This is -done for convenience (eg returning/taking Python lists or dicts), because arguments are -scalar (non-object) types passed by reference (eg int*, bool&), or because there is no -way to express the C++ type in Python (eg template types) -</p> -<p> -Please check the <a href="docs.html">Class Reference Docs</a> which list all classes -and methods in Python format. -</p> -<h2>Version Information</h2><h4><i>New in PyKDE-3.11</i></h4> -<p> -PyKDE provides methods for determining both the KDE version being run and the PyKDE -version being run. The version methods are: -</p> -<table border="0" bgcolor="#E0E0E0" width="100%"> -<tr> -<th align = "left" width = "20%"><u>return type</u></th> -<th align = "left" width = "20%"><u>KDE</u></th> -<th align = "center" width = "10%"><u>Example</u></th> -<th></th> -<th align = "left" width = "20%"><u>PyKDE</u></th> -<th align = "center" width = "20%"><u>Example</u></th> -</tr> -<tr> -<td>int</td> -<td>KDE.versionMajor ()</td> -<td align = "center">3</td> -<td></td> -<td>PyKDE.versionMajor ()</td> -<td align = "center">3</td> -</tr> -<tr> -<td>int</td> -<td>KDE.versionMinor ()</td> -<td align = "center">1</td> -<td></td> -<td>PyKDE.versionMinor ()</td> -<td align = "center">8</td> -</tr> -<tr> -<td>int</td> -<td>KDE.versionRelease ()</td> -<td align = "center">4</td> -<td></td> -<td>PyKDE.versionRelease ()</td> -<td align = "center">0</td> -</tr> -<tr> -<td>string</td> -<td>KDE.versionString ()</td> -<td align = "center">"3.1.4"</td> -<td></td> -<td>PyKDE.versionString ()</td> -<td align = "center">"3.11.0"</td> -</tr> -</table> - -<h2>Abstract Classes and Pure Virtual Methods</h2> -<P> -C++ allows the use of abstract classes. Abstract classes cannot be used in programs -(instantiated) directly; their only purpose is to serve as a base class from which -programmers can derive other classes that can be used. -</P> -<P> -An abstract class in C++ is defined as a class that has one or more 'pure virtual' -methods. These can be identified in the C++ header files or C++ docs as methods set -equal to 0, for example: -</P> -<TABLE BORDER="0" BGCOLOR="#E0E0E0" WIDTH="100%"> -<TR> -<TD> -<PRE CLASS="PROGRAMLISTING"> -virtual int somePureVirtualMethod (int a) = 0; -</PRE> -</TD> -</TR> -</TABLE> -<P> -To derive a useful class from the abstract class, the programmer has to write methods -to overload each of the pure virtual methods. Following a suggestion on the mailing -list, the docs attempt to flag all abstract classes and identify the pure virtual -methods which must be overloaded in the derived class. Derived classes can be created -in Python by writing Python methods to overload the pure virtual methods - no C++ code -is required. -</P> - -<DIV CLASS="NAVFOOTER"> -<HR ALIGN="LEFT" WIDTH="100%"> -<TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" > -<TR> -<TD WIDTH="33%" ALIGN="left" VALIGN="top"><A HREF="signal.html" ACCESSKEY="P">Prev</A></TD> -<TD WIDTH="34%" ALIGN="center" VALIGN="top"><A HREF="index.html" ACCESSKEY="H">Home</A></TD> -<TD WIDTH="33%" ALIGN="right" VALIGN="top"><A HREF="classref/index.html" ACCESSKEY="N">Next</A></TD> -</TR> -<TR> -<TD WIDTH="33%" ALIGN="left" VALIGN="top">Signals and Slots</TD> -<TD WIDTH="34%" ALIGN="center" VALIGN="top"> </TD> -<TD WIDTH="33%" ALIGN="right" VALIGN="top">Class Reference</TD> -</TR> -</TABLE> -</DIV> - -</BODY> -</HTML> |