diff options
author | Timothy Pearson <kb9vqf@pearsoncomputing.net> | 2011-12-05 00:17:19 -0600 |
---|---|---|
committer | Timothy Pearson <kb9vqf@pearsoncomputing.net> | 2011-12-05 00:17:19 -0600 |
commit | d070aee4c277d331e54b81ac2881977a8d8cb7c0 (patch) | |
tree | 81fc5f857e6f4eafafd48f2ae70a787e02d10c5d /examples/pytde-sampler/HOWTO.samples | |
parent | 01bd7e2ffdc3caa95228e03ad501d778b05270a9 (diff) | |
download | pytde-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.samples | 60 |
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 + + + + |