kdelibs

mirror of https://bitbucket.org/smil3y/kdelibs.git synced 2025-02-24 10:52:49 +00:00

History

Ivailo Monev d398932909 generic: drop Phonon in favour of MPV and custom player classes kcompactdisc was remove because there is no use for it in the current set of applications supported, if it is needed it will need some work to make it use KMediaPlayer or whatever. the Plasma VideoWidget class was dropped because custom widgets (at some point) will be dropped unless absolutely needed and hopefully getting rid of the heavy-weight QML stuff. the new KMediaPlayer and KMediaWidgets classes are experimental but they have been tested and they work as they should. Signed-off-by: Ivailo Monev <xakepa10@gmail.com>		2016-03-20 02:43:02 +00:00
..
pics	generic: optimize png images with optipng	2015-07-20 17:35:19 +03:00
tests	initial import	2014-11-13 01:04:59 +02:00
AUTHORS	initial import	2014-11-13 01:04:59 +02:00
classpreviews.cpp	initial import	2014-11-13 01:04:59 +02:00
classpreviews.h	initial import	2014-11-13 01:04:59 +02:00
CMakeLists.txt	generic: drop Phonon in favour of MPV and custom player classes	2016-03-20 02:43:02 +00:00
kde.widgets	generic: drop Phonon in favour of MPV and custom player classes	2016-03-20 02:43:02 +00:00
kdewebkit.widgets	initial import	2014-11-13 01:04:59 +02:00
kdewebkitwidgets.qrc	initial import	2014-11-13 01:04:59 +02:00
kdewidgets.qrc	initial import	2014-11-13 01:04:59 +02:00
makekdewidgets.cpp	kdewidgets: support Katie	2015-11-09 21:19:46 +02:00
README	initial import	2014-11-13 01:04:59 +02:00

README

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


Summary:
========

This directory contains KDE custom widgets for Qt Designer which comes with
Qt 4. Just make sure that QT_PLUGIN_PATH includes
$KDEDIR/lib/kde4/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 >= 4.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>