TDE core libraries
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Timothy Pearson ed99a30644 Rename additional header files to avoid conflicts with KDE4 7 years ago
..
pics Rename many classes and header files to avoid conflicts with KDE4 7 years ago
tests Rename additional header files to avoid conflicts with KDE4 7 years ago
AUTHORS Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. 10 years ago
CMakeLists.txt Rename additional header files to avoid conflicts with KDE4 7 years ago
Makefile.am Rename a number of libraries and executables to avoid conflicts with KDE4 7 years ago
README Rename KDEHOME and KDEDIR 8 years ago
classpreviews.cpp Rename additional global TQt functions 8 years ago
classpreviews.h Trinity Qt initial conversion 9 years ago
kde.widgets Rename additional header files to avoid conflicts with KDE4 7 years ago
makekdewidgets.cpp Rename common header files for consistency with class renaming 7 years ago

README

KDE Custom Widgets for Qt Designer 2
====================================


Summary:
========

This directory contains KDE custom widgets for designer 2 which comes with
Qt 3. Just make sure your plugin path in qtconfig includes
$TDEDIR/lib/trinity/plugins . With the KDE build system nothing special
(i.e. editing the plugin path) is needed, as uic will automatically be
called with -L <path to the kdewidgets plugin> .

This plugin uses the QWidget plugin API of Qt >= 3.0
Don't expect it to work with any other versions of Qt.


Known Bugs:
===========

Designer crashes when using widgets that use the kapp pointer.

HOWTO Add Widgets:
==================
Just add new widgets to kde.widgets like this:
[ClassName]
IncludeFile=myheader.h
IconSet=mycoolwidget.png
ToolTip=My Cool Widget
WhatsThis=Long description of my cool widget
ConstructorArgs=(parent, name, otherNeccessaryArg)
IsContainer=true
Group=MyWidgetCollection

Everything but [ClassName] is optional.
IncludeFile defaults to classname.h (all lowercase)
IconSet defaults to classname.png (all lowercase)
ToolTip defaults to ClassName
WhatsThis defaults to ClassName
ConstructorArgs=(parent, name)
IsContainer defaults to false - note, any value except an empty one is
interpreted as true, even if the value
is "false" :) So, if the widget is not a
container, just omit this line.
Group defaults to "KDE"

Don't forget to add an icon to the pics directory. Try to make it look similar to the other icons and be the same size.

There are some global options that you can have.

[Global]
Init=new InitCode();
Destroy= delete object;
PluginName=MyPlugin

PluginName overrides the passed in value at the command line and is optional.
Init and Destroy are both optional arguments that can be used for custom build
up and tear down code.

Have fun!


Ian Reinhart Geiser <geiseri@kde.org>
Daniel Molkentin <molkentin@kde.org>
Malte Starostik <malte@kde.org>