summaryrefslogtreecommitdiffstats
path: root/examples/pytde-sampler/HOWTO.samples
diff options
context:
space:
mode:
authorTimothy Pearson <kb9vqf@pearsoncomputing.net>2011-12-05 00:17:19 -0600
committerTimothy Pearson <kb9vqf@pearsoncomputing.net>2011-12-05 00:17:19 -0600
commitd070aee4c277d331e54b81ac2881977a8d8cb7c0 (patch)
tree81fc5f857e6f4eafafd48f2ae70a787e02d10c5d /examples/pytde-sampler/HOWTO.samples
parent01bd7e2ffdc3caa95228e03ad501d778b05270a9 (diff)
downloadpytde-d070aee4c277d331e54b81ac2881977a8d8cb7c0.tar.gz
pytde-d070aee4c277d331e54b81ac2881977a8d8cb7c0.zip
Finish pykde to pytde rename
Diffstat (limited to 'examples/pytde-sampler/HOWTO.samples')
-rw-r--r--examples/pytde-sampler/HOWTO.samples60
1 files changed, 60 insertions, 0 deletions
diff --git a/examples/pytde-sampler/HOWTO.samples b/examples/pytde-sampler/HOWTO.samples
new file mode 100644
index 0000000..2b20c52
--- /dev/null
+++ b/examples/pytde-sampler/HOWTO.samples
@@ -0,0 +1,60 @@
+How to Write Samples for the PyKDE Sampler
+==========================================
+
+
+Create or locate a directory within the sampler application root directory.
+
+Add a module.
+
+In side the module, add the following:
+
+- iconName - string (optional)
+ default: 'filenew'
+ example: 'colorize'
+
+ When supplied, this should be the short name of a KDE icon, such as
+ 'stop', 'editclear', etc. If available, This icon will be used as
+ the list item's icon in the sampler. Not all icons are available in
+ all themes, so try to use the icons that are available in the
+ default KDE installation.
+
+
+- labelText - string (optional)
+ default: module name
+ example: 'KMessageBox'
+
+ When supplied, this value is used as the list item text for the
+ sample. If it's not supplied, the application will use the name of
+ the module instead.
+
+
+- docParts - two-tuple (optional)
+ default: None
+ example: ('tdeui', 'KAboutDialog')
+
+ If specified, this sequence should contain two items, first item
+ name of pytde module, second item name of class within the module.
+ These two values are used to form the URL to the documentation for
+ the sample.
+
+
+- one of buildWidget, buildDialog, buildApp, MainFrame - callable (retquired)
+ default: None
+ example: MainFrame(TQFrame): ...
+
+ The sample module must contain a callable with one of these names.
+ The callable must accept a single positional parameter, the parent
+ widget.
+
+ In most cases, it is sufficient to define a subclass of TQFrame named
+ 'MainFrame'. To construct a more complex sample, define a function
+ with one of the other names.
+
+ The callable should return (or instatiate) a widget for display in
+ the main sampler widget. The created frame is responsible for
+ displaying it's help text and for any providing any widgets
+ necessary to
+
+
+
+