kdelibs/kdewidgets
Ivailo Monev 061a11fd43 kdeui: replace KDatePicker/KDateTable with new KCalendarWidget class
interestingly QLocale is not used for many things but that is about to
change, Katie uses it a lot internally (e.g. for QDateTime formatting
and such) so instead of bolting a calendar system on top of KLocale
perhaps a QLocale wrapped around in KLocale will fit the general idea
of using QLocale in widgets when necessary (as does QCalendarWidget).

that however means no way to specify a calendar system (in general,
other than changing the widgets locale itself) but the QDateTime and
related classes are tied to gregorian calendar already - the system
time itself carries no information about the calendar and any
conversions from one calendar to another are basically made up stuff
(there is the time zone thing ofcourse but that is not a calendar)

another interesting thing to note is that KLocale was written such that
it is read-write - changing the date formats for example is possible
because there are public KLocale methods for that.

Signed-off-by: Ivailo Monev <xakepa10@gmail.com>
2023-07-23 06:16:56 +03:00
..
pics kdeui: replace KDatePicker/KDateTable with new KCalendarWidget class 2023-07-23 06:16:56 +03:00
AUTHORS initial import 2014-11-13 01:04:59 +02:00
CMakeLists.txt plasma: remove unused test engine and containment 2023-07-07 19:19:49 +03:00
kde.widgets kdeui: replace KDatePicker/KDateTable with new KCalendarWidget class 2023-07-23 06:16:56 +03:00
makekdewidgets.cpp kdewidgets: minor optimization and description update 2023-05-23 05:35:50 +03:00
README kdewidgets: actually support init/destroy code 2021-08-03 18:36:14 +03:00

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]
Includes=foo.h,bar.h
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>