| blob | 9eec763c9595af34885bf81c8615438f69918549 |
2 <html>
3 <head>
7 <!--
8 body {
13 }
18 }
24 }
30 }
34 }
36 pre {
48 }
49 -->
50 </style>
51 </head>
52 <body>
56 <p>All modules should build from /trunk/KDE/kdelibs; there is no snapshot branch any longer. Major changes happen on Mondays (in any timezone) so expect rapid changes during that time. Things should be generally stable otherwise, but this <b>is</b> the development area, so there are no guarantees.</p>
60 <p>This document contains the changes you have to apply to programs written for
65 <UL>
89 </UL>
93 <p>As a start you should have a look at doc/html/porting4.html in the Qt package,
97 followed by kdesdk/scripts/qt4/adapt-to-qt4-api.pl and kdesdk/scripts/qt4/adapt-to-kde4-api.pl</p>
102 <ul>
103 <li>
104 The "const char *name" arguments in the constructors of QObject derived classes
105 have been removed. Use setObjectName() instead if the object name is really necessary.
106 </li>
107 <li>The define KDE_DEPRECATED must be used now at the start of the declaration
109 KDE_DEPRECATED does not work with constructors, use KDE_CONSTRUCTOR_DEPRECATED
110 instead.</li>
111 </ul>
124 <ul>
127 <li>Most of KImageEffect is now available in blitz; the bits that aren't can be done with QPainter.
128 <ul>
129 <li>Qt has gradients now, please use them if you can. Otherwise blitz has gradients ala KImageEffect.</li>
130 </ul>
131 </li>
132 <li>KPixmapEffect was little more than a wrapper around pixmap->image->KImageEffect->image->pixmap. Use the replacements for KImageEffect.</li>
133 <li>kdrawutils.h is gone.
134 <ul>
135 <li>If you already ported your code to KDE4, your code now has a copy of whatever kdrawutil code you were using.</li>
136 <li>If you haven't ported your code yet, you get to find a copy of what you need in svn's revision history (or in branches/3.5).</li>
137 </ul>
138 </li>
139 <li>The functionality of KPixmapSplitter cen be emulated with this code, courtesy of Matt Newell:
140 <pre>
141 QRect getFlowedRect(int index, const QSize &itemSize,
142 int layoutWidth, int h_spacing, int v_spacing)
143 {
144 // NOTE: if using h_spacing, depending on your use you might want to replace
145 // layoutWidth with (layoutWidth + h_spacing)
146 int itemsPerRow = layoutWidth / (itemSize.width() + h_spacing);
147 return QRect( QPoint( (index % itemsPerRow) * (itemSize.width() + h_spacing),
148 (index / itemsPerRow) * (itemSize.height() + v_spacing) ),
149 itemSize );
150 }
151 </pre>
152 </li>
154 </ul>
160 <ul>
172 </ul>
175 <ul>
176 <li>KAboutData::setTranslator needs different parameters now.
177 (Please see the corresponding Doxygen comment for the current state.)</li>
178 <li>new catalogName parameter to constructor can be null or empty, then appName is used as catalog name</li>
179 <li>all setter methods return object reference, so they can be chained to avoid repeating object name (eg. for addAuthor(), addCredits(), etc.)</li>
180 </ul>
181 <p>I18N_NOOPs in general replaced with KLocalizedString, produced by ki18n()/ki18nc() calls,
182 or just KLocalizedString() if wanted empty.
186 <p>Removed. Replaced by the new KAction/QAction framework.
187 See KActionCollection::associateWidget() if you need the old KAccel widget-binding behavior.</p>
190 <ul>
192 <li>[Old note] KDE3 supported 3 modifier key shortcuts and 4 modifier key (3+META) shortcuts, because earlier versions of Qt3 didn't
193 support a META modifier/WIN key. This is changed, so now all shortcuts can be 4 modifier key. All instances of
195 <li>[Old note] The constructor, init(), and insert() functions now only take only KShortcut "default" argument instead of two</li>
196 <li>[Old note] Removed shortcutDefault3() and shortcutDefault4(). Use shortcutDefault() instead</li>
197 </ul>
203 <ul>
204 <li>Moved to kdeui. This means no change for GUI applications.
205 For text-based applications, you should consider switching to QCoreApplication + KComponentData.
206 There are two cases:
207 <ul>
208 <li>Command-line argument parsing needed: use KCmdLineArgs as usual and then
210 <li>No command-line argument parsing needed: simply create a KComponentData (with &aboutData or just a name),
212 </li>
213 </ul>
214 <li>Of course if you don't create a KApplication, then you should turn any "kapp->" into "qApp->" in the
215 rest of the code.</li>
216 <li>KApplication does not inherit KInstance/KComponentData anymore. The KComponentData object is
217 available through KGlobal::mainComponent() (if KApplication is the first object to create a
218 KComponentData object, but everything else probably is a bug).</li>
219 <li>caption() was moved to KGlobal; you can now use it if you don't have a KApplication object</li>
221 </ul>
222 <ul>
224 <li>keyboardMouseState() has been removed, its functionality is now provided by QApplication::keyboardModifiers() and QApplication::mouseButtons() </li>
226 <li>For using the kiosk restriction/authorization system you have to use the functions provided in KAuthorized. </li>
227 <li>invoke* functions have been moved to ktoolinvocation. there are static methods invoke*, if you want to use slots as before connect to the invoke* slots of KToolInvocation::self() </li>
230 <li>getDisplay() has been removed, its functionality is now provided by QX11Info::display() </li>
231 <li>cut(), copy(), paste(), clear() and selectAll() were moved to KStandardAction. Rather then creating a copy action and connecting it to kapp just use the KStandardAction::copy </li>
234 <li>geometryArgument was removed, please use:
235 <pre>
236 QString geometry;
237 KCmdLineArgs *args = KCmdLineArgs::parsedArgs("kde");
240 </pre>
241 </li>
243 <li>propagateSessionManager(), requestShutDown() methods and associated ShutdownConfirm, ShutdownType and ShutdownMode enums have been moved into the kworkspace library (which is found in kdebase/workspace/lib); the methods are static functions in KWorkspace namespace. </li>
246 <li>installKDEPropertyMap has been moved into k3sqlpropertymap.h and renamed to kInstallKDEPropertyMap. It can be used to keep old c
247 ode that uses the Q3Data* classes working.For new code, use User in the meta object to determine which Q_PROPERTY to use for any widget.
248 <pre>
249 const QMetaObject *metaObject = widget->metaObject();
251 const QMetaProperty metaProperty = metaObject->property(i);
252 if (metaProperty.isUser()) {
253 QString propertyToUse = metaProperty.name();
254 break;
255 }
256 }
257 </pre>
258 </li>
260 <li>makeStdCaption(const QString&, bool, bool) has moved to KDialog and changed signature to makeStdCaption(const QString&, CaptionFlags) </li>
261 <li>addKipcEventMask() is unneeded now, and the signals like settingsChanged(), fontChanged() etc. with enums SettingsCategory have moved to KGlobalSettings::self() which is now a QObject</li>
262 <li>updateRemoteUserTimestamp() now takes DBUS service id instead of dbus name (i.e. something like org.kde. needs to be prepended)</li>
263 </ul>
269 <p>Renamed to KCatalog. Method name parts with "catalogue" have been renamed to use "catalog" instead.</p>
272 <ul>
273 <li>KCharsets::codecForName cannot use glibc's i18n data anymore.
275 <li>The user-visible encoding names are now mostly upper-case
276 (instead of being always lower-case).</li>
277 <li>KCharsets::languageForEncoding should be replaced
278 by KCharsets::descriptionForEncoding. The function KCharsets::languageForEncoding is planned to be removed before the release of KDE4.</li>
280 does not support this encoding.</li>
281 <li><b>TODO</b>: see which member functions can be removed. The functions handling entites are planned to be moved out of the class KCharsets.</li>
282 </ul>
285 <ul>
288 </ul>
291 <ul>
293 </ul>
296 <p>This class was removed. It was a very thin wrapper around KConfig and should
297 be replaced.</p>
298 <ul>
299 <li>If you use an absolute path, just change KSimpleConfig with KConfig - there was
300 no difference between uses of them for KDE3 either.</li>
303 </ul>
306 <ul>
307 <li>setGroup is deprecated as it creates state. Use group(QString) to receive
308 a KConfigGroup object or create a KConfigGroup object yourself:
309 <pre>
310 KConfig *config = KGlobal::config();
313 </pre>
314 should be rewritten as
315 <pre>
318 </pre>
319 </li>
320 <li>setDesktopGroup is gone. Use KDesktopFile (and its desktopGroup() method) if
322 <li>It's no longer necessary to specify a KConfig object is read-only - they are always
323 unless you use change it</li>
324 <li>The KConfig constructors were changed to receive flags instead of boolean values, i.e.
325 <ul>
329 </ul>
330 </li>
331 </ul>
334 <ul>
335 <li>all read*Entry methods deprecated, use <b>template <typename T> readEntry(key, const T&)</b> in KConfigGroup instead.
336 This uses QVariant in the background so only types that QVariant can convert to QString work. The use of QVariant allows some ambiguous conversions, so it might be necessary to use <em>explicit</em> construction to disambiguate the type wanted, i.e.
337 <ul>
340 <li>QColor var = readEntry(key, QColor(<b>Qt::black</b>)); // no conversion from Qt::GlobalColor to QVariant
341 <li>long var = readEntry(key, <b>0</b>); // conversion from long to QVariant is ambiguous, so can't use <b>long(0)</b>.</li>
342 </ul>
343 If you need to access top-level config entries (those without any group), use KConfigGroup with the group name <i><default></i>.
344 </li>
345 <li>readEntry(const QString&, const QString&) no longer has a default argument, add QString() as
346 second argument.
347 </li>
348 <li>all writeEntry* methods removed, mostly not noticeable, but some types don't automatically convert
349 to QVariant. You need to cast to a type that is directly convertible to QVariant. i.e.
350 <pre>
351 time_t timeVal;
352 group.writeEntry("someKey", timeVal); // ambiguous conversion
353 group.writeEntry("someKey", int(timeVal)); // ok
354 </pre>
355 </li>
356 <li>all read*ListEntry methods deprecated, renamed to KConfigGroup::readEntry. Most types use the template version.<br/>
357 <b>template <typename T> readEntry(key, const QList<T>&)</b><br/>If you just write group.readEntry(key, list) it should work for any type that QVariant can convert to QString.
358 </li>
359 <li>writeEntry, deleteGroup, and deleteEntry do not take several boolean options (persistent,global,localized) anymore, but instead one QFlags</li>
360 </ul>
363 <p>
364 The class KConfigGroupSaver has been removed, instead use KConfigGroup. The
365 difference is a KConfigGroupSaver object directly affects the config object it
366 is acting on, while a KConfigGroup object only ensures the entries read or
367 written through it are in the correct group.</p>
368 Instead of:
369 <pre>
370 KConfig *config = KGlobal::config();
371 KConfigGroupSaver saver(config, "group name");
372 ...
374 </pre>
375 should be rewritten as:
376 <pre>
378 ...
379 cg.readXXX("entry name");
380 </pre>
383 <ul>
384 <li> static void init(int _argc, char **_argv, const char *_appname, const char *_description, const char *_version, bool noKApp = false) KDE_DEPRECATED; -> static void init(int _argc, char **_argv, const QByteArray &appname, const QByteArray &catalog, const KLocalizedString &programName, const QByteArray &version, const KLocalizedString &description = KLocalizedString(), StdCmdLineArgs stdargs=StdCmdLineArgs(CmdLineArgQt|CmdLineArgKDE)));
387 <li> KLocalizedString objects produced by ki18n()/ki18nc() calls (instead of previous I18N_NOOPs), or just KLocalizedString() if needed empty</li>
388 <li> static void usage(const QString &error) -> static void usageError(const QString &error)</li>
389 </ul>
392 Now a proper class, instead of statically initialized struct. Use add() method for adding options (option syntax same as before); add() returns object reference, so calls can be chained to avoid repeating variable name all the way.
395 <ul>
396 <li>value based class using shared data: In KDE4 don't work with pointers to KComponentData anymore.
397 Internally it is reference counted and the data deleted when the last reference goes out of scope.</li>
402 </ul>
407 function info, so printing the function name by hand, or using
409 performed implicitly. The type of stream used is now
412 <p>Instead of repeating the debug area all over the place, define
414 <pre>
416 + kDebug() << "entered";
417 </pre>
419 <pre>
420 + add_definitions( -DKDE_DEFAULT_DEBUG_AREA=1234 )
421 </pre>
424 <ul>
426 <li>more standards compliant. See
428 Desktop Entry Spec</a>
429 <ul>
433 </ul>
434 </li>
435 <li>Same as in KConfig: the use of readEntry() or writeEntry() on a KDesktopFile should
436 be replaced by readEntry/writeEntry on a KConfigGroup. By default the desktopGroup() of
438 </ul>
444 <ul>
446 </ul>
449 <ul>
450 <li>"int kasciistricmp( const char *str1, const char *str2 )" has been moved into kascii.h</li>
455 <li>static members _locale, _instance and so on are private now, if you want to get or set the
456 KLocale use locale()/setLocale()/hasLocale() and if you want to know whether a mainComponent is set use
457 hasMainComponent()</li>
460 </ul>
464 <p><b>Note:</b> at the moment you have to keep using K3Icon as a namespace for states, groups, and contexts though.</p>
474 <ul>
475 <li>When replacing KKey(QKeyEvent*), you need to OR the event->key() and event->modifiers() to get the replacement.</li>
477 <li>modFlagLabel() was removed, use either KKeyServer::modToStringUser(), or QKeySequence(Qt::yourmodifier).toString()</li>
478 </ul>
485 <p>Removed. Use QKeySequence instead.
486 Note that QKeySequence expects multiple shortcuts to be separated by ", " (i.e. a comma then a space) in converting from text.</p>
489 <ul>
491 <li>The resolve(const char* name) and symbol(const char* name) methods were merged and renamed to resolveSymbol</li>
493 <li>resolveFunction( const char* name ) was added which returns not a void* but a KLibrary::void_function_ptr which can be used as a void* would in boolean tests and for making subsequent function calls.</li>
494 </ul>
497 <ul>
500 </ul>
503 <ul>
504 <li>use K_PLUGIN_FACTORY macro instead: this will require to change your plugin constructor from QStringList to QVariantList</li>
505 <li>instead of K_EXPORT_COMPONENT_FACTORY use K_EXPORT_PLUGIN (defined with KPluginLoader) which adds Qt and kdelibs version information that KPluginLoader uses to check the validity of the plugin.</li>
506 </ul>
509 <ul>
510 <li> QString formatNumber(const QString &numStr) const -> QString formatNumber(const QString &numStr, bool round=true, int precision=2) const;</li>
512 <li> QString monthName(int i, bool shortName = false) const -> QString KCalendarSystem::monthName (int month, int year, bool shortName = false) const = 0; or QString KCalendarSystem::monthName (const QDate & date, bool shortName = false ) const = 0;</li>
513 <li> QString weekDayName(int i, bool shortName = false) const -> calendar()->weekDayName</li>
514 <li> QString monthNamePossessive(int i, bool shortName = false) const -> calendar()->monthNamePossessive()</li>
516 <li> QString formatDate(const QDate&, bool shortFormat = false) const -> QString formatDate(const QDate&, DateFormat = LongDate) const</li>
517 <li> QString formatDateTime(const QDateTime&, bool shortFormat = true, bool includeSecs = false) const -> QString formatDateTime(const QDateTime&, DateFormat = ShortDate, bool includeSecs = false) const</li>
519 <li> formatMoney(const QString &numStr) -> QString formatMoney(double num, const QString & currency = QString::null, int digits = -1) const;</li>
526 <li>QString twoAlphaToLanguageName(const QString &language) -> QString languageCodeToName(const QString &language)</li>
527 <li>QString twoAlphaToCountryName(const QString &country) -> QString countryCodeToName(const QString &country)</li>
528 </ul>
532 <ul>
534 </ul>
537 <p>KMimeSourceFactory was automatically instanciated by KApplication which allowed the use of "icon:name" in Qt richtext.
538 Q3MimeSourceFactory being in Qt3Support, and this feature being very rarely used, K3MimeSourceFactory isn't instanciated
539 automatically anymore, you need to call K3MimeSourceFactory::install() in your main if you still depend on this feature.</p>
542 <p>KMultipleDrag is obsolete, use QMimeData directly to provide contents in different mime formats.</p>
543 <p>To make porting more incremental, K3MultipleDrag is provided for code that needs to work with
544 Q3DragObject until being fully ported.</p>
556 <p>Removed. Simply use a QString to represent the path or identifier. See the documentation on KLocalSocket.</p>
559 <ul>
560 <li>All of these classes are deprecated. Use the QTcpSocket,
561 QUdpSocket and QTcpServer equivalents from QtNetwork.</li>
562 <li>When porting, use KSocketFactory when creating any sockets that
563 are used to communicate with remote hosts (that is, anything that is
568 <pre>
569 QString host;
570 int port;
572 KBufferedSocket *socket = new KBufferedSocket(parent);
573 if (!socket->connect(host, QString::number(port))) {
574 // error happened
575 // deal with it
576 }
577 connect(socket, SIGNAL(connected(KResolverEntry)), SLOT(socketConnected()));
578 connect(socket, SIGNAL(gotError(int)), SLOT(socketError(int)));
579 </pre>
582 <pre>
583 QString protocol;
584 QString host;
585 int port;
586 QUrl url(QString("%1://%2:%3").arg(prototocol, host).arg(port));
588 QTcpSocket *socket = KSocketFactory::connectToHost(protocol, host, port, parent);
589 // alternatively:
590 // QTcpSocket *socket = KSocketFactory::connectToHost(url, parent);
591 connect(socket, SIGNAL(connected()), SLOT(socketConnected()));
592 connect(socket, SIGNAL(error(QAbstractSocket::SocketError), SLOT(QAbstractSocket::SocketError)));
593 </pre>
597 <pre>
598 int port;
600 KServerSocket *ss = new KServerSocket(QString::number(port), parent);
601 connect(ss, SIGNAL(readyAccept()), this, SLOT(slotReadyAccept()));
602 connect(ss, SIGNAL(gotError(int)), this, SLOT(slotSocketError(int)));
603 ss->listen();
604 </pre>
607 <pre>
608 QString protocol;
609 int port;
611 QTcpServer *ts = KSocketFactory::listen(protocol, QHostAddress::Any, port, parent);
612 connect(ts, SIGNAL(newConnection()), this, SLOT(slotReadyAccept()));
613 </pre>
614 </li>
617 "blocking" mode for QTcpSocket. If you need an action to complete,
620 to wait for a connection to be established,
622 </ul>
625 <p>Replaced by KNotification. The API is quite similar, but the config file need to be updated. See KNotification documentation, and the file kdelibs/knotify/PORTING.html</p>
628 <p>The kde3 version was deprecated and renamed to K3Process, header is k3process.h.
629 Its usage is discouraged as it will create problems when being used together with
630 the new KProcess or QProcess in the same application, this is more of a problem in
631 applications that use KParts or plugins and can't control what those plugins do.</p>
632 <ul>
633 <li>start() lost all arguments, the setup of communication and program/arguments
634 has to be done before starting the process</li>
639 </ul>
651 This class has been deprecated by KDateTime. It has been renamed K3RFCDate and moved to the libkde3support. The following method changes make porting easy:
652 <ul>
653 <li>KRFCDate::parseDate( string ) becomes KDateTime::fromString( string, KDateTime::RFCDate).toTime_t();</li>
654 <li>KRFCDate::parseDateISO8601( string ) becomes KDateTime::fromString( string ).toTime_t();</li>
655 <li>KRFCDate::localUTCOffset() becomes KDateTime::Spec::LocalZone().utcOffset / 60. Note that the KRFCDate version returned minutes while KDateTime returns seconds.</li>
656 </ul>
659 <ul>
661 <ul>
664 <li>KSaveFile::numberedBackupFile() will create a numbered set of backup files (default: 10)</li>
666 </ul></li>
667 <li>KSaveFile now derives from QFile so you can use it just like you would use a normal QFile. The close() function has been renamed to finalize(). Use the error() and errorString() functions to check for errors instead of status().</li>
670 </ul>
676 <p>Removed - no longer needed. Saving and loading of shortcuts is now performed in KActionCollection, KGlobalAccel, and KStandardShortcut.</p>
679 <ul>
681 </ul>
684 <ul>
685 <li>boolean values as parameters for recursive, unique and checking for executability in the following methods were changed to instead take SearchOptions flags for improved code readability:
686 <ul>
692 </ul>
693 </li>
694 </ul>
697 <ul>
700 <li>shortcutDefault3() and shortcutDefault4() have been removed, use shortcutDefault() instead</li>
701 </ul>
704 <p>Either use K3StaticDeleter or port to the <a href="http://api.kde.org/4.0-api/kdelibs-apidocs/kdecore/html/group__KDEMacros.html#g75ca0c60b03dc5e4f9427263bf4043c7">K_GLOBAL_STATIC</a> macro.
710 <ul>
711 <li>static QString ljust( const QString &text , int width ) -> QString::leftJustified</li>
712 <li>static QString rjust( const QString &text , int width ) -> QString::rightJustified</li>
719 </ul>
722 <ul>
727 </ul>
731 <p>When porting old KTempFile calls to KTemporaryFile, you need to remember that KTempFile by default will not automatically remove the fileonce the object is destroyed, but KTemporaryFile will! You also need to call open() in order to actually create the file.</p>
734 <ul>
740 <li>fromPathOrURL() is deprecated, use the KUrl(str) constructor which now accepts both paths and urls</li>
741 <li>htmlURL() had to be removed, please use Qt::escape(url.prettyUrl()) now, with #include <QTextDocument>.
742 This requires libQtGui, which is why it can't be in KUrl anymore.</li>
743 <li>url(0,106) or any other use of the 'mib enum' for encoding has been removed. QUrl is UTF8 based, and the world is becoming more and more utf8 based as well, the old encoding hacks inside urls should disappear.</li>
744 <li>Runtime behavior change: port() used to return 0 if no port was specified. It now returns -1 in that case, or you can use port(defaultPort) to set what it should return if no port was specified.</li>
745 <li>adjustPath(), path(), encodedPathAndQuery() , url() , prettyUrl() was taking a int argument for handling trailing slash that has been replaced by an enum AdjustPathOption (0 => KUrl::LeaveTrailingSlash, 1 => KUrl::AddTrailingSlash, -1 => KUrl::RemoveTrailingSlash).
746 <li>cleanPath(), queryItems(), fileName(), directory(), equals() now take a QFlags argument instead of boolean</li>
747 <li>*URL* renamed to *Url*:
748 <ul>
755 </ul>
756 </li>
757 </ul>
760 <p>This class has been moved to kde3support. Use KUrl::populateMimeData() and
761 KUrl::List::populateMimeData() in the drag/copy side,
762 and the static methods KUrl::List::canDecode() and KUrl::List::fromMimeData()
763 in the drop/paste side.</p>
764 <ul>
768 if ( !uriList.isEmpty() ) {</pre></li>
769 </ul>
775 This class has been merged with KWinModule into class KWindowSystem (in kdeui).
776 <ul>
780 </ul>
783 This class has been merged with KWinModule into class KWindowSystem (in kdeui).
784 Don't create instances, use static functions and KWindowSystem::self() for connecting to signals.
785 <ul>
786 <li>Functions related to systemtray have been removed. They worked only with the obsolete
787 KDE systray mechanism.</li>
788 <li>stackingOrder() no longer returns a reference to a list. Make a copy of the value first if using iterators.</li>
789 </ul>
792 This class has been renamed KWindowInfo and moved to its own header: KWindowInfo or kwindowinfo.h. This class is not to be confused with KWindowInfo in KDE3 which was a small utility class to display message in the window icon and title. KWindowInfo represents the windowing system information for a give window, such as its geometry, desktop positioning, type, name, etc.
795 <ul>
797 </ul>
800 <ul>
801 <li>NETRootInfo(Display *display, Window supportWindow, const char *wmName,unsigned long properties, int screen = -1, bool doActivate = true) ->
802 NETRootInfo(Display *display, Window supportWindow, const char *wmName,
803 const unsigned long properties[], int properties_size,
804 int screen = -1, bool doActivate = true); old properties is the first element of the new array
805 </li>
808 <li> WindowType windowType() -> WindowType windowType( unsigned long supported_types ) const;</li>
809 </ul>
814 <ul>
821 <li>KLanguageButton (and therefore klanguagebutton.h) was removed due to licensing issues (GPLv2, which is not allowed in kdelibs)</li>
830 </ul>
833 <p>Deprecated and renamed to K3AboutContainer. Use KAboutApplicationDialog or KAboutKdeDialog directly.</p>
834 <ul>
838 </ul>
841 <p>Deprecated and renamed to K3AboutContributor. Use KAboutApplicationDialog or KAboutKdeDialog directly.</p>
842 <ul>
849 </ul>
852 <p>Deprecated and renamed to K3AboutDialog. Use KAboutApplicationDialog or KAboutKdeDialog directly.</p>
853 <ul>
855 <pre>
856 AbtPlain -> Plain
857 AbtTabbed -> Tabbed
858 AbtTitle -> Title
859 AbtImageLeft -> ImageLeft
860 AbtImageRight -> ImageRight
861 AbtImageOnly -> ImageOnly
862 AbtProduct -> Product
863 AbtKDEStandard -> KDEStandard
864 AbtAppStandard -> AppStandard
865 AbtImageAndTitle -> ImageAndTitle
866 </pre>
867 </li>
868 <li>Constructor: K3AboutDialog( QWidget *parent = 0, bool modal = true ) -> KAboutDialog( QWidget *parent = 0 )</li>
869 <li>Constructor: K3AboutDialog( int dialogLayout, const QString &caption, ButtonCodes buttonMask,
870 ButtonCode defaultButton, QWidget *parent=0, bool modal=false, bool separator = false,
871 const QString &user1 = QString(),
872 const QString &user2 = QString(),
874 K3AboutDialog( int dialogLayout, const QString &caption, QWidget *parent = 0 ) (see KDialog how to port)</li>
882 </ul>
885 <p>Deprecated and renamed to K3AboutWidget. Use KAboutApplicationDialog or KAboutKdeDialog directly.</p>
886 <ul>
889 </ul>
892 <p>Making KAction a subclass of QAction (actually QWidgetAction) brings KDE more into line with the Qt way of creating user interfaces, improves accessibility, and removes code duplication.</p>
893 <p>QAction in Qt4 is a true first-class citizen - all QWidgets now have a list of associated actions, and QToolBar, QMenu etc. all use this list directly to show the graphical items (widgets, entries in the menu, etc). This has replaced all usage of integers as "id"s. There is also a new QEvent (QActionEvent), and the corresponding virtual protected function in QWidget, actionEvent().</p>
894 <ul>
899 <li>there is a replacement for activation providing keyboard + mouse states, see triggered(Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers) [currently buggy]</li>
900 <li>plugAccel(), unplugAccel(), kaccelCount() removed - they have no use now (accelerator management is inside Qt)</li>
901 <li>itemId(), getToolButtonID() removed - actions no longer have ids, basically the QAction* is its replacement</li>
902 <li>setGroup() / group() removed - use QActionGroup instead (setActionGroup() / actionGroup())</li>
903 <li>ActivationReason has been removed (not supported by Qt). For a surrogate, you can connect to QMenu::triggered(QAction*), QToolBar::actionTriggered(QAction*), etc.</li>
904 <li>setters are no longer slots; where they were used as such, an intermediary will be required</li>
905 <li>New feature from Qt: statusTip() / setStatusTip(). Usually this will be the same as the tooltip. It appears in the status bar whenever the action is hovered in a QMenu. A porting convenience is being investigated for automatic toolTip() -> statusTip(), but the best solution is to set both.</li>
906 <li>New feature: globalShortcut() and globalShortcutAllowed(). Automatically communicates with KGlobalAccel to register a global shortcut (i.e. one that does not need the application to have focus to be activated).</li>
907 <li>setShortcut() now defaults to setting the default shortcut as well (as it was by far the most common use case). To just set the custom shortcut, use setShortcut(myShortcut, KAction::CustomShortcut)</li>
910 <li>Functions in KActionCollection or KXMLGUIFactory for example don't take or return KAction pointers
911 anymore but instead operate on QAction pointers. If you get compilation errors with code like the
912 following then just replace KAction with QAction:
913 <pre>
915 ...
916 </pre>
917 Also if you get errors about KAction being an unknown type it is often enough to forward declare
918 KAction in your header file.
926 <li>unplugAll() -> Rarely needed, but if you are sure that you need it replace it with the following
927 code:
928 <pre>
929 foreach (QWidget *w, action->associatedWidgets())
930 w->removeAction(action);
931 </pre>
932 <li>The KAction constructors changed completely. The constructors taking various action properties,
933 a pointer to an acion collection and the name of the action have been removed. The new pattern is to
934 create the actions like regular QObjects with a parent (owner). Then you set various properties using
935 setText, setIcon, etc. . As a last step the action can be added to the action collection with a name.
936 <pre>
937 KAction *a = new KAction(this);
940 a->setShortcut(Qt::ControlModifier + Qt::Key_A);
942 </pre>
943 KActionCollection additional provides convenience overloads for creating named KAction objects or
944 standard actions (KStandardAction). For example:
945 <pre>
948 connect(a, SIGNAL(triggered()), this, SLOT(portedToKde4()));
950 actionCollection -> addAction(KStandardAction::Copy, this, SLOT(copy()))
951 </pre>
952 </ul>
955 <ul>
956 <li>constructor (QWidget* watch, ..) and setWidget() replaced by associateWidget() - allows actions to respond to matching key presses on a widget level (basically a convenience method to have all actions in the collection added to the associated widget(s) and their shortcut scopes set to Qt::WidgetShortcut). (note: associateWidget() replaces {set|add|remove}AssociatedWidget() from kde4 beta)</li>
959 <li>New functions setConfigGroup(), setConfigGlobal(), configGroup(), configIsGlobal() - the action collection now stores the group whether the config is global. referenced in readSettings() / writeSettings()</li>
960 <li>readShortcutSettings() and writeShortcutSettings() renamed without the "Shortcut". Set the configGroup() with setConfigGroup() either prior to each call, or (preferably) at the creation time of the action collection.</li>
961 <li>{set}HighlightingEnabled(), {connect|disconnect}Highlight() removed - highlighting is always enabled now</li>
962 <li>actionHighlighted(), actionStatusText(), clearStatusText() removed - use QAction::setStatusTip() as a replacement. QStatusBars belonging to QMainWindow automatically get the statusTip() applied to them when they are moused over in a QMenu, via a QStatusTipEvent.</li>
963 <li>groups() removed (now using QActionGroups) - see actionGroups() (and actionsWithoutGroup()) for replacement</li>
964 <li>actions( const QString& group ) removed - use actionGroups() instead, and then QActionGroup::actions()</li>
965 <li>action(const char* name, const char* className) removed: action(const QString& name), actions(const QString& name), actionOfType<Class>(const QString& name), actionsOfType<Class>(const QString& name) are the replacements</li>
969 </ul>
972 <ul>
976 </ul>
979 <p>Used to be renamed to KSeparatorAction. KSeparatorAction/KActionSeparator is dead now. Just create a QAction object and call setSeparator(true); on it.</p>
980 <p><b>Note:</b> you need to create multiple separator actions if you want to insert multiple separators into a widget, unlike with KDE3.</p>
984 <ul>
986 <li>Use QLabel::setTextInteractionFlags(Qt::TextSelectableByMouse|Qt::TextSelectableByKeyboard) for labels whose text should be selectable by user.</li>
988 <li>You don't need anymore to disconnect the linkClicked signal to handle manually link, use KTextBrowser::setNotifyClick(true)</li>
990 </ul>
993 <ul>
997 </ul>
1006 <ul>
1008 </ul>
1011 <p>Deprecated and renamed to K3ButtonBox. Use KDialogButtonBox instead. Add the role parameter to the addButton function. Or check if it can't be achieved using KDialog.</p>
1017 <ul>
1018 <li>Cleaned up constructor, removed char, font and table arguments. The concept of showing tables isn't used any more and all functions/signals are removed. There is no need for a replacement.</li>
1025 <li>enableFontCombo(), enableTableSpinBox(), isFontComboEnabled() and isTableSpinBoxEnabled() are removed.</li>
1027 </ul>
1030 <ul>
1034 <li>The parameters of the colorSelected() and colorDoubleClicked() signals now include both the index of the color which
1035 was selected and the color itself as arguments</li>
1036 </ul>
1039 <ul>
1044 </ul>
1047 <p>Deprecated and renamed to K3ColorDrag. Use QMimeData directly instead or KColorMimeData, which most closely resembles KColorDrag</p>
1050 <p>New class that provides access to system-wide, user configurable color roles.
1051 Like QPalette, the return type is now QBrush instead of QColor.
1055 the active palette == the inactive palette (because this is really helpful for
1056 the oxygen windeco which does not use "traditional" windeco colors, and because
1057 for various reasons kwin can't be entirely responsible for the effect). When
1058 porting to KDE4, you will need to take this into consideration. The new class
1059 KStatefulBrush has been added to help with this, as well as the adjustForeground
1060 and adjustBackground methods of KColorScheme.</p>
1062 <p>There are lots of bugs as a result of this; some in applications, and at
1063 least a few in Qt. Please report application bugs to the appropriate maintainer
1064 or list, and general (i.e. occurring in many/all applications) bugs to
1067 <p>See the <a href="http://api.kde.org/4.0-api/kdelibs-apidocs/kdeui/html/classKColorScheme.html">KColorScheme documentation</a> for further information.</p>
1070 <ul>
1073 </ul>
1076 <ul>
1083 </ul>
1092 <ul>
1096 </ul>
1099 <ul>
1101 <li>signal void settingsChanged(const char *dialogName); -> void settingsChanged(const QString& dialogName);</li>
1102 <li>signal void settingsChanged(); has disappeared - use the signal with the parameter instead. If you don't need the parameter don't connect it, e.g <pre>connect(myDialog, SIGNAL(settingsChanged(const QString&)), this, SLOT(mySlot()));</pre></li>
1103 </ul>
1106 <ul>
1107 <li>KContextMenuManager::insert() :
1109 <pre>
1110 KContextMenuManager::insert(widget, menu);
1111 </pre>
1113 <pre>
1114 widget->setContextMenuPolicy(Qt::ActionsContextMenu);
1116 </pre>
1117 <li>Otherwise consider handling the context menu in a contextMenuEvent() handler, which Qt
1118 calls automatically on a right-mouse-button click or on activation by the context menu key.
1119 There's no need to do anything in mousePressEvent/mouseReleaseEvent/keyPressEvent.
1120 </ul>
1123 <ul>
1125 <li>The static methods for loading various cursor types are gone, just use QCursor( Qt::CursorShape ) directly instead</li>
1126 </ul>
1129 <ul>
1136 </ul>
1139 <ul>
1143 </ul>
1146 <ul>
1148 </ul>
1151 <ul>
1152 <li>Simplified ctor.
1153 <pre>
1154 The following ctor
1156 KDialog dlg( parent, i18n("my caption"), modal, Ok | Cancel | User1, Ok, false, i18n("Share File"))
1158 should be rewritten as
1160 KDialog dlg( parent );
1161 dlg.setCaption( i18n("my caption") );
1162 dlg.setModal( modal );
1163 dlg.setButtons( Ok | Cancel | User1 );
1164 dlg.setButtonGuiItem( User1, i18n("Share File") );
1165 dlg.setDefaultButton( Ok );
1166 dlg.showButtonSeparator( false );
1167 </pre>
1168 </li>
1171 <li>setButtonOKText, setButtonApplyText , setButtonCancelText -> setButtonText( ButtonCode, const QString& )</li>
1173 <li>don't overide anymore slotFoo(). You now need to connect to FooClicked signal.
1174 Or reimplement accept() and reject() to intercept the Ok and Cancel button</li>
1177 </ul>
1181 <ul>
1182 <li>If the KDialogBase is Swallow or Plain mode you should replace it with KDialog, for
1183 all other modes use KPageDialog
1184 <pre>
1185 Replace
1187 QWidget *page = plainPage();
1189 with
1191 QWidget *page = new QWidget( this );
1192 setMainWidget( page );
1194 All makeXXXMainWidget() methods can be replaced by the following schema:
1196 KVBox *mainWidget = makeVBoxMainWidget();
1198 replace with
1200 KVBox *mainWidget = new KVBox( this );
1201 setMainWidget( mainWidget );
1202 </pre>
1203 </li>
1204 <li>If you use a KPageDialog, the following steps must be taken...
1205 <pre>
1206 Replace ctor
1210 with
1212 KPageDialog dlg( parent );
1213 dlg.setFaceType( KPageDialog::Tabbed );
1214 dlg.setObjectName( name );
1215 dlg.setModal( modal );
1216 dlg.setCaption( i18n( "my caption" ) );
1217 ...
1219 All addXXXPage() methods can be replaced by the following schema:
1223 replace with
1225 KVBox *page = new KVBox();
1226 KPageWidgetItem *item = addPage( page, i18n( "My Title" ) );
1229 </pre>
1230 </li>
1231 <li>The virtual methods associated with each button (slotOk(), slotCancel(), etc.) have been merged into a single KDialog::slotButtonClicked(int button) virtual method. However, the most direct replacement for slotOk() and slotCancel() is to reimplement QDialog::accept() and QDialog::reject(), respectively. For all other buttons, consider connect()ing to the corresponding signals provided by KDialog (helpClicked(), etc.).
1232 </li>
1233 </ul>
1236 <p>This class is obsolete and is provided for compatibility only. Use KSystemTrayIcon instead.</p>
1242 <ul>
1243 <li>The signal gotUrlDrop was removed, nobody used it, and it's easy to do in the application
1244 if needed (see the KURLDrag section)</li>
1245 </ul>
1248 <ul>
1249 <li>void insertStrList(const QStrList* list, int index=-1) and void insertStrList(const QStrList& list, int index=-1) have been deprecated, use QStringList or const char** instead</li>
1250 </ul>
1253 <ul>
1256 <li>The constructors have been simplified to take either a KActionCollection* or a KXMLGUIFactory*, depending on whether the app is using XMLGUI or not. To set a non-default resource file in the KActionCollection* case, call setResourceFile.</li>
1257 </ul>
1260 <ul>
1262 <li>The constructors have been simplified to take either a KActionCollection* and a parent widget or just a parent widget. The latter is for use with XMLGUI. Before being shown, the new load() methods should be called. These allow for populating the widget before being shown but after construction, which is useful when allowing the resource file to be changed as in KEditToolBar.</li>
1263 </ul>
1266 <ul>
1267 <li>The constructors have been simplified to take an optional parent. Other parameters must be set by using the API directly, e.g. setHasSelection and setSearch.</li>
1268 <li>The options argument in the constructor is now an enumerated flag of type KFind::Options.</li>
1271 </ul>
1274 <ul>
1275 <li>Was in kfontdialog.h, but was moved to it's own header, so now either do #include <KFontChooser> or #include <kfontchooser.h></li>
1276 <li>The KFontChooser constructors now take a set of flags to determine how it is displayed, which replaces the numerous bools used previously. The following mappings from the bools in KDE3 and the enum in KDE4 are as follows:
1277 <ul>
1281 </ul>
1282 </li>
1283 </ul>
1286 <ul>
1287 <li>The KFontDialog constructor now takes a set of flags to determine how it is displayed, which replaces the numerous bools used previously. The following mappings from the bools in KDE3 and the enum in KDE4 are as follows:
1288 <ul>
1292 </ul>
1293 </li>
1294 <li>The second argument for getFontDiff() is now a reference to a KFontChooser::FontDiffFlags instead of an int.</li>
1295 </ul>
1298 <ul>
1302 <li>You shouldn't need to access this class much... just use setGlobalShortcut() in KAction.</li>
1303 </ul>
1306 <ul>
1308 <li>KGlobalSettings is now a QObject so can emit signals like kdisplayPaletteChanged() instead of KApplication</li>
1309 <li> deprecated "static QString trashPath()" has been removed. use KIO::trash instead</li>
1310 <li>Palette color accessors have been removed. Libraries should restrict themselves to colors available in QPalette (always use the widget's palette and not a global palette), otherwise use an appropriately constructed KColorScheme instead. This does not include/affect WM color accessors.</li>
1311 </ul>
1314 <ul>
1315 <li>Reversed the value range, if orientation is horizontal. Now minimum is on the left and maximum on the right side.</li>
1316 </ul>
1319 <ul>
1320 <li>Don't use setIconSet anymore, use setIcon instead, there is no compatibility class or function</li>
1321 </ul>
1325 <ul>
1326 <li>Was in kcombobox.h, but was moved to it's own header, so now do #include <khistorycombobox.h></li>
1327 </ul>
1330 <ul>
1332 </ul>
1335 <ul>
1337 <li>Thin wrapper around QIcon which creates a KIconEngine corresponding to the kde named icon</li>
1338 </ul>
1341 <ul>
1343 <li>Deprecated loadIconSet(), DesktopIconSet(), BarIconSet(), SmallIconSet(), UserIconSet(): use KIcon(name) or KIcon(name,instance->iconLoader()) instead.<br/>
1344 Note that this can change slightly the look of the icon in some cases: for instance if code was calling setIcon(BarIconSet())
1345 on a pushbutton, it meant the icon was loaded at toolbar size and then resized down.
1346 With KIcon(name), the small icon is picked up instead, which might look different, but this is the correct behavior.
1347 These deprecated methods were also altered to not take a KComponentData (KInstance* in KDE3), which was an optional parameter in KDE3.</li>
1348 <li>the State parameter was used to be both define the state of the icon one of a limited number of overlays. Overlays are now a separate parameter, a QStringList, containing the names of icons to overlay. The new overlays parameter now follows the state parameter.</li>
1349 </ul>
1352 <ul>
1353 <li>static QString KInputDialog::text( const QString &caption,...) was replaced by QString KInputDialog::getText( const QString &caption,...)</li>
1354 </ul>
1357 <ul>
1361 </ul>
1364 <ul>
1366 </ul>
1369 <ul>
1370 <li>In the long version of the constructor, the arguments parent and base have switched places.</li>
1371 </ul>
1377 <p>Removed. Use either KKeySequenceWidget or KShortcutWidget. Use KShortcutWidget only if you really want two possible shortcuts. Both don't pop up a modal dialog.</p>
1386 <ul>
1389 </ul>
1392 <ul>
1395 <li>void setEnableSqueezedText( bool enable ) -> void setSqueezedTextEnabled( bool enable )</li>
1399 </ul>
1412 There is no direct KDE replacement for this class yet.<br>
1413 Either use KListWidget for list-based widgets or QTreeWidget for tree-based
1414 widgets. Note that only QTreeWidget supports headers.</p>
1418 You should port from K3ListView to QTreeWidget and then use
1419 KTreeWidgetSearchLine instead.</p>
1425 <ul>
1426 <li>getMemberList() was replaced by memberList() and memberList was renamed to mMemberList and made it private</li>
1427 <li>sizeForCentralWidgetSize(QSize size) returned the size the main window should have so that the central widget will be of size. You normally don't need this, the recommended way to achieve a certain central widget size is as follows.<br>
1428 * Override sizeHint() in the central widget so that it returns the desired size.<br>
1429 * Call updateGeometry() in the central widget whenever the desired size changes. This ensures that the new sizeHint() is properly propagated to any parent layout.<br>
1430 * Now call adjustSize() in the main window to resize the main window such that the central widget will become the desired size.</li>
1433 <li>If you need XmlGui functions from KMainWindow you may want to use KXmlGuiWindow instead of KMainWindow.</li>
1434 </ul>
1437 <ul>
1439 <li>function processDynamic arguments uses DCOPCString instead of QCString :
1440 <pre>bool processDynamic(const DCOPCString &fun, const QByteArray &data, DCOPCString& replyType, QByteArray &replyData);</pre></li>
1442 </ul>
1445 <ul>
1447 <li>title, titlePixmap, and changeTitle removed - use QAction::text(), QAction::icon(), QAction::setText() and QAction::setIcon</li>
1448 <li>contextMenuFocusItem changed to contextMenuFocusAction in line with the change from indexes to actions</li>
1449 </ul>
1452 <ul>
1453 <li>Where applicable, the static functions now take an additional argument to specify the cancel button. Since a default argument is provided, this will affect your code only, if you specified dontAskAgainName and/or options. In those cases, adding an additional parameter KStandardGuiItem::cancel() leads to the old behavior. The following functions are affected (omitting function arguments in the list): questionYesNoCancel(), questionYesNoCancelWId(), warningContinueCancel(), warningContinueCancelWId(),
1454 warningContinueCancelList(), warningContinueCancelListWId(), warningYesNoCancel(), warningYesNoCancelWId(), warningYesNoCancelList(), warningYesNoCancelListWId(), messageBox(), messageBoxWId().</li>
1455 </ul>
1461 <ul>
1463 </ul>
1466 <ul>
1468 </ul>
1471 <ul>
1473 </ul>
1476 <p>Deprecated and renamed to K3PasswordEdit. Use KLineEdit, with KLineEdit::setPasswordMode(true).</p>
1480 <ul>
1484 <!-- <li>kpassdlg.h was renamed kpassworddialog.h.</li> -->
1485 <!-- <li>checkPassword take now a QString as argument</li> -->
1486 </ul>
1487 <pre>
1488 KPasswordDialog dlg(parent);
1489 dlg.setPrompt( prompt );
1490 dlg.setWindowTitle( caption );
1491 if( dlg.exec() != QDialog::Accepted )
1492 return;
1493 use( dlg.password() );
1494 </pre>
1500 <ul>
1503 </ul>
1509 <p>Removed; QMenu doesn't accept widgets, and QAction allows specification of font, icon etc... and gradients / background pixmaps weren't even working in KDE3. You can use KMenu::addTitle() instead, which creates QAction.</p>
1513 <ul>
1515 <li>QProgressBar has changed a lot in Qt4 ( setTotalSteps(totalSteps) -> setRange(0, totalSteps), setProgress -> setValue, percentageChanged -> valueChanged ). For more details see QProgressBar class reference.</li>
1516 </ul>
1519 <ul>
1521 <li>progressBar() is a now QProgressBar instead of a KProgressBar -> See KProgress API changes</li>
1523 </ul>
1526 <ul>
1527 <li>Don't use setIconSet anymore, use setIcon instead, there is no compatibility class or function</li>
1528 </ul>
1531 <p>Removed. Use KAction (or KToggleAction if you need different text/icons for the selected state) instead, in combination with an exclusive QActionGroup</p>
1534 <ul>
1538 </ul>
1544 <ul>
1548 </ul>
1551 <ul>
1552 <li>KSeparator now uses Qt::Vertical and Qt::Horizontal rather then QFrame's HFrame and VFrame.</li>
1553 </ul>
1556 <p>Moved from kdecore, renamed from KSessionManaged, and moved to it's own header: ksessionmanager.h or KSessionManager</p>
1562 <ul>
1567 <li>Introduced "primary" and "alternate" shortcuts to replace the arbitrary list of shortcuts</li>
1570 <li>Added a qHash(const KShortcut &) function so you can use QHash with KShortcut instead of QMap</li>
1574 </ul>
1577 <ul>
1578 <li>Added new constructor parameter: ActionTypes types. Allows you to filter the types of actions shown in the dialog.</li>
1579 <li>Removed all functions dealing with old classes KShortcutList, KGlobalAccel (kde3 version)</li>
1582 </ul>
1586 <ul>
1587 <li>Changed from edit/commit semantics to edit in-place/revert semantics. The old way didn't work in corner cases, the new way is quite a bit less complicated internally, and such cases only appear if a user opens multiple KKeyDialogs at the same time, which nobody does intentionally.</li>
1588 <li>Rewritten. It was hard to read, which stood in the way of future changes/improvements.</li>
1591 <li>Added new constructor parameter: KKeyChooser::ActionTypes types. Allows you to filter the types of actions shown in the dialog.</li>
1592 </ul>
1595 <ul>
1600 </ul>
1604 <ul>
1605 <li>showToolbar() methods have been removed, see KMainWindow::setStandardToolBarMenuEnabled()</li>
1606 </ul>
1610 <ul>
1612 </ul>
1615 <ul>
1616 <li>Use K3SyntaxHighlighter because it used Q3TextEdit or use KSyntaxHighlighter when your application will use QTextEdit</li>
1617 </ul>
1620 <p>Renamed to KSystemTrayIcon for consistency with its actual purpose and naming in Qt (QSystemTrayIcon).</p>
1621 <ul>
1622 <li>Is now a subclass of QSystemTrayIcon and not QLabel. Therefore it is not a widget anymore. Otherwise, it behaves the same as in KDE3 when it comes to managing a parent window's visibility and providing an action collection to display in the context menu.</li>
1623 </ul>
1626 <ul>
1628 <li>The old insertTab and removeTab have been removed, use addTab / insertTab / removeTab from QTabBar instead (uses indices, not QTab*s)</li>
1629 </ul>
1635 <ul>
1637 </ul>
1640 <ul>
1642 </ul>
1651 <ul>
1652 <li>setExclusiveGroup() / exclusiveGroup() removed, use setActionGroup() and QActionGroup::setExclusive() for exclusivity (imitates the deleted KRadioAction class)</li>
1654 </ul>
1657 <ul>
1658 <li>Simplified constructor
1659 <pre>
1660 Replace
1662 KToggleFullScreenAction( const KShortcut &cut, const QObject* receiver, const char* slot,
1663 KActionCollection* parent, QWidget* window, const QString& name )
1665 with
1667 KToggleFullScreenAction( QWidget* window, KActionCollection* parent, const QString& name )
1670 </pre>
1671 </li>
1672 </ul>
1675 <ul>
1678 <li>BarPosition, barPos(), setBarPos() replaced by Qt::ToolBarArea settings in QMainWindow; Unmanaged, Floating, and Flat are no longer supported (use QDockWidget if you need floating toolbars)</li>
1679 <li>fullSize(), setFullSize() removed as now handled in QMainWindow - add or insert a tool bar break before (not needed for the first toolbar) and after the toolbar using QMainWindow::{add|insert}ToolBarBreak() to have the toolbar take up all available horizontal space</li>
1680 <li>iconSize(), setIconSize() now a QToolBar property, and a QSize instead of an int - convenience function setIconDimensions() takes an int instead</li>
1681 <li>insert*() and all associated item-manipulation methods removed - all done through actions now. Compatibility layer possible however so far I haven't found the functions to be used much in KDE programs (mostly it's taken care of by xmlgui instead)</li>
1682 <li>flat(), setFlat() replaced by movable(), setMovable() (old "flat" concept equivalent to not movable)</li>
1684 <li>alignItemRight() removed (as above), replacement is to add a KToolBarSpacerAction before the action you want to be aligned right (or if you have a custom action already, just create a container widget and insert a QSpacerItem on the left of your custom widget (see KonqLogoAction in kdebase/konqueror/konq_actions.cc)</li>
1686 removed</li>
1693 <li>void setEnableContextMenu(bool enable = true) -> void setContextMenuEnabled(bool enable = true)</li>
1694 </ul>
1700 <ul>
1701 <li>Simplified constructors:
1702 <pre>
1703 Replace
1705 KToolBarLabelAction( const QString &text,
1706 const KShortcut &cut,
1707 const QObject *receiver, const char *slot,
1708 KActionCollection *parent, const QString& name )
1710 with
1712 KToolBarLabelAction( const QString &text,
1713 KActionCollection *parent, const QString& name )
1715 and
1717 KToolBarLabelAction( QAction *buddy, const QString &text,
1718 const KShortcut &cut,
1719 const QObject *receiver, const char *slot,
1720 KActionCollection *parent, const QString& name )
1722 with
1724 KToolBarLabelAction( QAction *buddy, const QString &text,
1725 KActionCollection *parent, const QString& name )
1728 See KAction for how to port the other arguments.
1729 </pre>
1730 </li>
1731 </ul>
1743 <ul>
1755 </ul>
1774 <ul>
1775 <li>void setPreviewWidget(const KPreviewWidgetBase *w) -> void setPreviewWidget(KPreviewWidgetBase *w)</li>
1776 </ul>
1779 <ul>
1781 <li>The API has changed for subclasses: there is a KArchive constructor that takes a filename, and which provides KSaveFile support automatically, writeDir is doWriteDir, prepareWriting is doPrepareWriting etc.</li>
1782 <li>API changes for users of the class: isOpened() was renamed to isOpen(),
1783 doneWriting() to finishWriting(), and the order of the arguments for writeFile() is more usual:
1784 data comes before size.</li>
1789 </ul>
1792 <ul>
1793 <li>KBookmarkDrag class has been moved to kde3support. Use KBookmark::populateMimeData() and
1794 KBookmark::List::populateMimeData() in the drag/copy side,
1795 and the static methods KBookmark::List::canDecode() and KBookmark::List::fromMimeData()
1796 in the drop/paste side.</li>
1797 <li>KBookmarkMenu constructor is much simpler. It always creates a toplevel menu, which makes the parameter isRoot and parentAddress superfluous. KBookmarkOwner now governs wheter to show a "Add Bookmark" Menu Entry, thus the constructor parameter add is gone.</li>
1798 <li>KBookmarkMenu and KBookmarkBar no longer emits openBookmark(), override KBookmarkOwner::openBookmark() instead. </li>
1800 <li>KExtendBookmarkOwner functionality was integrated into KBookmarkOwner. (And the API is more regular now.)</li>
1801 <li>KBookmarkMenu::slotBookmarksChanged() and KBookmarkMenu::fillBookmarkMenu() are no longer public. Both had comments, that they shouldn't be used anyway.</li>
1803 </ul>
1806 <ul>
1807 <li>All the static methods have been moved to KDesktopFileActions, in kdesktopfileactions.h</li>
1808 </ul>
1811 <ul>
1812 <li>The constructor argument is now a separate setter, so: KDirLister(false) -> KDirLister(); KDirLister(true) -> KDirLister() + setDelayedMimeTypes(true). On the other hand, KDirLister being a QObject, it takes a QObject* parent argument.</li>
1813 <li>KDirLister uses KFileItem by value now:
1814 <ul>
1816 <li>KFileItem* findByUrl( const KUrl& url ) const -> KFileItem findByUrl( const KUrl& url ) const</li>
1817 <li>KFileItem* findByName( const QString& name ) const -> KFileItem* findByName( const QString& name ) const</li>
1818 <li>bool matchesFilter( const KFileItem* ) const -> bool matchesFilter( const KFileItem& ) const</li>
1819 <li>bool matchesMimeFilter( const KFileItem* ) const -> bool matchesMimeFilter( const KFileItem& ) const</li>
1820 </ul>
1821 </li>
1822 <li>The following signals have changed:
1823 <ul>
1824 <li>void deleteItem( KFileItem *_fileItem ) -> void deleteItem( const KFileItem &fileItem )</li>
1825 <li>void refreshItems( const KFileItemList &items ) -> void refreshItems( const QList<QPair<KFileItem, KFileItem>> &entries)</li>
1826 </ul>
1827 </li>
1828 </ul>
1831 <ul>
1833 </ul>
1836 <ul>
1837 <li>This class is removed due to its inflexiblity, use cyrus-sasl or the upcoming QCA SASL implementation</li>
1838 </ul>
1841 <ul>
1842 <li>KDirSelectDialog moved to libkfile. If you were only using the static method selectDirectory, you can use KFileDialog::getExistingDirectory (for local files, i.e. if the second argument was true), or KFileDialog::getExistingDirectoryUrl</li>
1843 </ul>
1846 <ul>
1849 </ul>
1852 <ul>
1854 </ul>
1857 <ul>
1858 <li>Changed constructor and method 'startDir' arguments from QString to KUrl
1860 <pre>
1861 Affected methods:
1863 KFileDialog( ... )
1864 static QString getOpenFileNameWId( ... )
1865 static QStringList getOpenFileNames( ... )
1866 static KUrl getOpenURL( ... )
1867 static KUrl::List getOpenURLs( ... )
1868 static QString getSaveFileName( ... )
1869 static QString getSaveFileNameWId( ... )
1870 static KUrl getSaveURL( ... )
1871 static QString getExistingDirectory( ... )
1872 static KUrl getExistingURL( ... )
1873 static KUrl getImageOpenURL( ... )
1874 </pre>
1875 </li>
1876 <li>getOpenURL, getOpenURLs, getExistingURL and getSaveURL were renamed to getOpenUrl, getOpenUrls, getExistingUrl and getSaveUrl (i.e. URL was replaced by Url everywhere)</li>
1880 <li>void setFilterMimeType(const QString &label, const KMimeType::List &types, const KMimeType::Ptr &defaultType) was removed</li>
1886 </ul>
1889 <ul>
1892 <li>Those classes have all moved to a new library, libkfile. You need to link to ${KDE4_KFILE_LIBS} to keep using those classes.</li>
1893 </ul>
1896 <ul>
1897 <li>KFileItemList has been ported from QPtrList to QList. This means you
1898 have to iterate using either integers or java-style or STL iterators.
1899 Here's the STL version:
1900 <pre>
1901 KFileItemList::const_iterator kit = list.begin();
1902 const KFileItemList::const_iterator kend = list.end();
1903 for ( ; kit != kend; ++kit )
1904 ...
1905 </pre></li>
1906 <li>Note however that no loop is necessary anymore for finding an item by name (use findByName), finding an item by URL (use findByURL) or making a list of all urls (use urlList).</li>
1907 </ul>
1911 <p>KFileMetaInfo has a new API and a new implementation. The change moves the emphasis away from mimetypes and groups of metadata to individual properties of files. These properties are still called KFileMetaInfoItem. The no longer belong to a group; they belong to the KFileMetaInfo object. The class KFileMetaInfoGroup is only there to group the items. Each KFileMetaInfoItem now has a member called PredicateProperties. This term comes from RDF. It determines the type of the item. This type encompasses the key (a URI), a name in the current locale, a description in the current locale, a type and a QValidator.
1912 </p>
1915 <ul>
1916 <li>This class has been removed, it was just a workaround for a dependency problem,
1917 just remove any instance of it.</li>
1918 </ul>
1922 <p>This class has been replaced by <a href="http://techbase.kde.org/Development/Tutorials/Writing_file_analyzers">Strigi analyzers</a> and KFileWritePlugin. The Strigi analyzer should be installed in the directory lib/strigi to be picked up. Introspection provided by the factories that are defined in the plugin helps in determining when a particular analyzer will be used.</p>
1924 <p>Strigi analyzer have the advantage that they are faster then KFilePlugins. In addition, having one mechanism for extracting metadata from files saves code and more importantly ensures consistency between the display of metadata and the ablility to search in it. Another advantage is that the way the metadata are described matches well with the methods employed in the semantic desktop, in particular Nepomuk.</p>
1928 <p>If your KFilePlugin only reads from files, it is easiest. Then you have to write only a Strigi analyzer. Depending on the way you read the data from the file it is best to write either a StreamThroughAnalyzer or a StreamEndAnalyzer. How to make the decision is explained in the link above. When your analyzer is ready you have to decide where to put it. You can put it in the same place as the KFilePlugin was or, if there are little or no dependencies in your analyzer, you can put it in kdesupport/strigi/src/streamindexer. The latter option has the advantage that you do not have to add the code for loading a plugin.</p>
1930 <p>When you have write functionality in your plugin, you must implement KFileWritePlugin and place the code for writing the file in there. The details of how to do this are not entirely clear at the moment as is explained in the entry for KFileWritePlugin.</p>
1934 <p>The write functionality of the class KFilePlugin is now handled by KFileWritePlugin. A global instance of this class that is attached to a KFileMetaInfoItem can be used to write back changes that were made to a files' metadata.</p>
1936 <p>The mechanism by which these global instances are tied to KFileMetaDataItems is not yet finished. The implementation of will go into kio/kio/kfilemetainfo.cpp.</p>
1939 <ul>
1941 </ul>
1944 <ul>
1946 </ul>
1949 <ul>
1950 <li>The KImageIO plugins are converted to Qt's imageformat plugins. The KImageIO class
1951 now a lightweight version to query the installed plugins without actually loading them.
1952 </li>
1953 <li>.kimgio files are converted to .desktop files, and contains regular KDE services,
1954 with ServiceType as QImageIOPlugins</li>
1958 </ul>
1961 <ul>
1962 <li>KIO::convertSizeFromKB is now KIO::convertSizeFromKiB since it takes a value in KiB (1 KiB = 1024 B)</li>
1963 <li>KIO::findDeviceMountPoint() has been replaced with KMountPoint::currentMountPoints() and findByDevice()</li>
1964 <li>KIO::findPathMountPoint() has been replaced with KMountPoint::currentMountPoints() and findByPath()</li>
1965 <li>KIO::probably_slow_mounted() has been replaced with KMountPoint::currentMountPoints(), findByPath(), and probablySlow()</li>
1966 <li>KIO::testFileSystemFlag() has been replaced with KMountPoint::testFileSystemFlag() (use KMountPoint::currentMountPoints().findByPath())</li>
1967 </ul>
1970 <ul>
1971 <li>For Job subclasses: removeSubjob doesn't terminate the parent job anymore, add
1973 <li>subjobs is now private. This means you should replace subjobs.remove(job) with removeSubjob(job),
1974 and subjobs.isEmpty() with !hasSubjobs()</li>
1975 <li><code>job->showErrorDialog(QWidget*)</code> becomes <code>job->ui()->showErrorMessage()</code>. The parent QWidget should be set immediately after creating the job by <code>job->ui()->setWindow(QWidget*)</code></li>
1976 <li><code>job->setAutoErrorHandlingEnabled(bool,QWidget*)</code> becomes <code>job->ui()->setAutoErrorHandlingEnabled(bool)</code></li>
1977 <li><code>job->isAutoErrorHandlingEnabled()</code> becomes <code>job->ui()->isAutoErrorHandlingEnabled()</code></li>
1978 <li><code>job->setAutoWarningHandlingEnabled(bool)</code> becomes <code>job->ui()->setAutoWarningHandlingEnabled(bool)</code></li>
1979 <li><code>job->isAutoWarningHandlingEnabled()</code> becomes <code>job->ui()->isAutoWarningHandlingEnabled()</code></li>
1980 <li><code>job->setWindow(QWidget*)</code> becomes <code>job->ui()->setWindow(QWidget*)</code></li>
1982 <li><code>job->setInteractive( false )</code> becomes <code>job->setUiDelegate( 0 )</code></li>
1983 <li>Also note that you must now include <kio/copyjob.h> if you use KIO::copy, KIO::move or KIO::trash,
1985 <li>For Job subclasses, there's no showProgressInfo flag in the constructor anymore. You should use KIO::getJobTracker()->registerJob(job) instead.</li>
1987 <li>Most boolean parameters have been replaced with enums. So for instance
1988 <ul>
1989 <li>KIO::file_copy(src, dest, -1, true /*overwrite*/, false /*no resume*/, false) -> KIO::file_copy(src, dest, -1, KIO::Overwrite | KIO::HideProgressInfo)</li>
1990 <li>KIO::get(url, false /*no reload*/, false) -> KIO::get(url, KIO::NoReload, KIO::HideProgressInfo)</li>
1991 <li>KIO::put(url, -1, true /*overwrite*/, false /*no resume*/, false) -> KIO::put(url, -1, KIO::Overwrite | KIO::HideProgressInfo)</li>
1992 <li>KIO::del(url, false /*shred, feature removed*/, false) -> KIO::del(url, KIO::HideProgressInfo)</li>
1993 <li>KIO::listDir(url, true /*show progress info*/, true /*include hidden files*/) -> KIO::del(url, KIO::DefaultFlags, true /*include hidden files*/)</li>
1994 </ul>
1995 </li>
1996 </ul>
1999 <ul>
2000 <li>UDSEntry is now a hash-based class instead of a list. Use the methods stringValue()
2001 and numberValue() to retrieve fields directly, no loop is needed anymore.
2002 See the UDSEntry documentation for code examples.</li>
2003 <li>Also note that UDSEntryListConstIterator is now UDSEntryList::ConstIterator;
2004 see the UDSEntryList documentation for a full code example of iterating through
2005 a listDir result.</li>
2006 <li>For kioslaves: replace every three lines like
2007 <pre>atom.m_uds = KIO::UDS_SIZE;
2008 atom.m_long = buff.st_size;
2009 entry.append( atom );</pre>
2011 </ul>
2015 <ul>
2016 <li>KIO::RenameDlg was renamed to KIO::RenameDialog and the header moved from renamedlg.h to renamedialog.h</li>
2026 </ul>
2029 <ul>
2030 <li>RenameDlgPlugin was renamed to KIO::RenameDialogPlugin and the header moved from renamedlgplugin.h to renamedialogplugin.h</li>
2031 <li>The ServiceType was changed from RenameDlg/Plugin to RenameDialog/Plugin. Make sure to update your .desktop fiel</li>
2032 </ul>
2035 <ul>
2036 <li>KIO::PassDlg was renamed to KIO::PasswordDialog and the header moved from passdlg.h to passworddialog.h</li>
2037 </ul>
2040 <ul>
2041 <li>KIO::PreviewJob works with KFileItems by value rather than by pointer, now that KFileItem is refcounted.</li>
2042 <li>The two signals changed accordingly:
2043 <ul>
2044 <li>gotPreview(const KFileItem*, const QPixmap&) -> gotPreview(const KFileItem&, const QPixmap&)</li>
2046 </ul>
2047 </li>
2048 <li>In the slots connected to those signals, don't compare KFileItem pointers! If you need to find the KFileItem
2049 in a list, compare the url() of the items in the list with the url() of the item passed to the slot.</li>
2050 </ul>
2053 <ul>
2054 <li>KIO::SkipDlg was renamed to KIO::SkipDialog and the header moved from skipdlg.h to skipdialog.h</li>
2055 </ul>
2058 <ul>
2062 </ul>
2065 <ul>
2067 </ul>
2070 <ul>
2071 <li>Removed distinction of SSL and TLS mode. You can now tell the slave via the constructor to start SSL right after connecting which is what was previously called "SSL mode". "TLS" is the same as starting SSL (using startSsl()) later than immediately after connecting. You can query if a slave was created with immediate SSL start enabled by calling isAutoSsl().</li>
2072 <li>Removed the notion of a default port. It was not used for any internal calculations - you can emulate it simply by having an "m_defaultPort" or similar member in a subclass.</li>
2076 <li>startSsl() (formerly startTLS()) now just returns a bool instead of a numeric error code.</li>
2077 <li>connectToHost() lost its sendError parameter. It was only used for proxy support hacks in the HTTP ioslave and nowhere else. Proxy support is better implemented inside TCPSlaveBase than in protocol slaves.</li>
2079 </ul>
2082 <ul>
2083 <li>The KMimeMagic class is gone. Use the KMimeType API instead:
2084 <ul>
2085 <li>KMimeMagic::self()->findFileType(path) -> KMimeType::findByPath(path) (preferred) or KMimeType::findByFileContent(path) (if only the content should be considered, but this isn't always reliable)</li>
2087 <li>KMimeMagic::self()->findBufferFileType(data,name) -> KMimeType::findByNameAndContent(name,data)</li>
2088 </ul>
2089 </li>
2091 </ul>
2094 <ul>
2095 <li>KMimeType::pixmap() has been deprecated (for core/gui separation), use iconName() or iconName(url)
2096 and KIconLoader::loadMimeTypeIcon with that icon name.</li>
2099 <li>KMimeType::diagnoseFileName has been replaced with KMimeType::extractKnownExtension which returns the extension only, not the pattern</li>
2100 <li>KMimeType::mimeType(someName) now behaves like KServiceType::serviceType(someName), i.e. it returns 0 if that name doesn't exist,
2101 instead of returning the application/octet-stream mimetype. Test for null!</li>
2102 <li>iconForURL has been deprecated, will possibly be removed for KDE 4.0 final, use iconNameForURL instead</li>
2103 <li>KMimeType::findFormatByFileContent has been removed. Use KMimeType::isBinaryData instead.</li>
2104 </ul>
2107 <ul>
2110 </ul>
2113 <ul>
2115 </ul>
2118 <ul>
2119 <li>Doesn't have autoShow support in its constructors anymore, but still has autodelete behavior.</li>
2120 <li>Ensure any new is followed by show or exec. Or use KPropertiesDialog::showDialog where possible.</li>
2121 <li>The header file was renamed from kpropsdlg.h to kpropertiesdialog.h
2122 <li>The ServiceType was renamed from KPropsDlg/Plugin to KPropertiesDialog/Plugin. Make sure to update your .desktop files </li>
2123 </ul>
2126 <ul>
2129 </ul>
2132 <ul>
2133 <li>Many static methods have been moved to KProtocolManager (which is in kio)
2134 so that kprotocolinfo itself could be moved to kdecore:
2135 <ul>
2136 <li>KProtocolInfo::supportsListing(url or protocol) -> KProtocolManager::supportsListing(url)</li>
2137 <li>KProtocolInfo::supportsReading(url or protocol) -> KProtocolManager::supportsReading(url)</li>
2138 <li>KProtocolInfo::supportsDeleting(url or protocol) -> KProtocolManager::supportsDeleting(url)</li>
2140 </ul>
2141 </li>
2142 <li>The deprecated methods taking a QString protocol as input have been removed, make sure
2143 to pass a KUrl to most methods instead.</li>
2144 </ul>
2147 <ul>
2149 </ul>
2152 <ul>
2154 </ul>
2157 <ul>
2161 </ul>
2164 <ul>
2166 </ul>
2169 <ul>
2171 </ul>
2174 <ul>
2178 <li>Ported to use KUrl instead of QString. Thus, the constructors, setUrl(), url(), and urlChanged() all use KUrl.</li>
2179 <li>Removed showLocalProtocol() and setShowLocalProtocol(); this is now always false (the user never sees file:///)</li>
2180 </ul>
2183 <ul>
2186 <li>KService::pixmap was removed due to icon support being moved to libkdeui. Instead use KService::icon() and KIconLoader directly. Usually you can simply use the KIconLoader returned by KApplication::iconLoader() for this.</li>
2187 </ul>
2190 <ul>
2192 <li>The behavior of KServiceType::serviceType() has changed: it now only returns real service types, and no more mimetypes. For mimetypes, use KMimeType::mimeType().</li>
2194 </ul>
2197 <ul>
2198 <li>This class has been moved to kservicetypeprofile.h and is mostly internal now. Use KServiceTypeTrader or KMimeTypeTrader instead.</li>
2199 <li>KServiceTypeProfile::preferredService is now KMimeTypeTrader::self()->preferredService or KServiceTypeTrader::self()->preferredService</li>
2200 <li>KServiceTypeProfile::offers is now KMimeTypeTrader::self()->query or KServiceTypeTrader::self()->query</li>
2201 </ul>
2204 <ul>
2206 <li>So KTrader::query() should be ported to KMimeTypeTrader::query() when it's about mimetypes
2207 (finding the application or part for a given mimetype), and to KServiceTypeTrader::query() when
2208 it's about pure service types (plugins, kcmodules, etc.)</li>
2210 KTrader::query(4 args but the last one was always QString::null) -> KMimeTypeTrader::query</li>
2211 <li>In both cases, query() now returns KService::List instead of an OfferList, adjust the type of the variable</li>
2214 </ul>
2217 <ul>
2218 <li>void setEnableUserField( bool enable, bool=false ) removed use setUsernameReadOnly( !enable )</li>
2219 </ul>
2223 <ul>
2224 <li>QByteArray openPassDlg( const KIO::AuthInfo >info ); removed. Use KIO::PasswordDialog::getNameAndPassword</li>
2225 </ul>
2232 <ul>
2233 <li>The following signals have changed:
2234 <ul>
2235 <li>openUrlRequest(const KUrl &, const KParts::URLArgs&) -> openUrlRequestDelayed(const KUrl &, const KParts::OpenUrlArguments&, const KParts::BrowserArguments&)</li>
2236 <li>openUrlRequestDelayed(const KUrl &, const KParts::URLArgs&) -> openUrlRequestDelayed(const KUrl &, const KParts::OpenUrlArguments&, const KParts::BrowserArguments&)</li>
2237 <li>The two createNewWindow signals have been merged into a single one: createNewWindow(url, args, browserArgs [, windowArgs, &part] )</li>
2238 <li>The popupMenu signals have been greatly simplified, 2 signals instead of 5. URLArgs has been split into OpenUrlArguments and BrowserArguments; the KXMLGUIClient argument has been removed, and the ActionGroupMap mechanism replaces it.</li>
2239 </ul>
2240 </li>
2241 <li>Because of the URLArgs split, make sure to replace BrowserExtension::setUrlArgs with BrowserExtension::setBrowserArguments + part->setArguments</li>
2242 </ul>
2245 <ul>
2246 <li>The following virtal methods have changed:
2247 <ul>
2248 <li>openURLInFrame(const KUrl &, const KParts::URLArgs&) -> openUrlInFrame(const KUrl &, const KParts::OpenUrlArguments&, const KParts::BrowserArguments&)</li>
2249 </ul>
2250 </li>
2251 </ul>
2254 <ul>
2259 </ul>
2262 <ul>
2267 <li>All the error codes like KParts::ComponentFactory::ErrNoServiceFound have moved to KLibLoader</li>
2268 </ul>
2271 <ul>
2272 <li>URLArgs has been splitted into OpenUrlArguments and BrowserArguments.
2273 <ul>
2279 <li>For anything else (docState, frameName, postData, setDoPost, setContentType etc.): URLArgs -> BrowserArguments</li>
2280 </ul>
2281 </li>
2282 <li>The BrowserArguments are still set and retrieved from the BrowserExtension, however the OpenUrlArguments are simply stored in KParts::ReadOnlyPart. So for instance:
2283 <ul>
2285 </ul>
2286 </li>
2287 </ul>
2293 <ul>
2294 <li>The class KDEDModule is now part of libkdecore so that kded modules can link without undefined symbols.
2295 A number of apparently unused methods in KDEDModule have been commented out, contact
2296 kde-core-devel if you need those after all.</li>
2297 <li>Note that the signature for the create_xyz() call has changed, simply remove all arguments from it,
2298 and from your kded module's constructor</li>
2299 </ul>
2307 <ul>
2309 <li>The KSpell2's initialization procedure of:
2310 <pre>
2311 KSpell2::Loader::Ptr loader = KSpell2::Loader::openLoader();
2313 if (speller) {
2315 //do something
2316 }
2317 }
2318 </pre>
2319 has been replaced with:
2320 <pre>
2321 Sonnet:Speller speller("en_US");
2322 if (speller.isMisspelled("word")) {
2323 //do something
2324 }
2325 </pre>
2326 </li>
2327 <li>The configuration class of KSpell2 (KSpell2::Settings) have been
2328 folded back into Sonnet::Speller.</li>
2329 <li>Sonnet doesn't automatically overwrite configuration anymore. To
2330 save and restore setting from a KConfig file one has to use
2331 <pre>
2332 Sonnet::Speller::save(KConfig *config);
2333 Sonnet::Speller::restore(KConfig *config);
2334 </pre>
2335 methods.</li>
2336 <li>KSpell2::Filter has been temporarily removed from the public api.
2338 </ul>
2345 <ul>
2347 <li>Constructor that takes list of domains and does not use configuration has been removed</li>
2349 </ul>
2352 <ul>
2353 <LI>Service properties are stored in QMap<QString,QByteArray> instead of QMap<QString,QString>.</LI>
2355 </ul>
2358 <ul>
2360 <li>In KDE3 ServiceBrowser created with default constructor (for example ServiceBrowser("_http._tcp") ) browsed all configured domains. Now it only browses default one. To browse other domains create more ServiceBrowser objects</li>
2361 <li>It is now possible to specify subtype to narrow searching scope (for example "anon" for only anonymous FTP servers)</li>
2363 </ul>
2369 <ul>
2372 </ul>
2375 <ul>
2387 <ul>
2390 </ul>
2393 <ul>
2396 <li>const KFileItemList* selectedItems() const -> QList<KFileItem> selectedItems() const</li>
2397 <li>KFileView* createView(QWidget *parent, KFile::FileView view) -> QAbstractItemView* createView(QWidget *parent, KFile::FileView view)</li>
2399 <li>void setPreviewWidget(const QWidget *w) -> void setPreviewWidget(KPreviewWidgetBase *w)</li>
2401 bool ask = true, bool showProgress = true) -> KIO::DeleteJob* del(const QList<KFileItem>& items, QWidget *parent = 0,
2402 bool ask = true, bool showProgress = true)</li>
2403 <li>KIO::DeleteJob* del(const KFileItemList& items, bool ask = true, bool showProgress = true) has been removed. Use del(...)
2404 with parent parameter instead.</li>
2406 bool ask = true, bool showProgress = true) -> KIO::CopyJob* trash(const QList<KFileItem>& items, QWidget *parent,
2407 bool ask = true, bool showProgress = true)
2408 </ul>
2411 <ul>
2413 <li>For ease of porting, kde3support provides K3FileView, but don't expect it to still be useable in a KDirOperator.</li>
2414 </ul>
2417 <ul>
2418 <li>void setPreviewWidget(const KPreviewWidgetBase *w) -> void setPreviewWidget(KPreviewWidgetBase *w)</li>
2419 </ul>
2431 <ul>
2432 <li>The Button enum in KCModule only contains the Help, Default and Apply
2433 values. The other buttons are not optional. If your KCM specified the button
2434 flags just remove everything except those three.</li>
2435 <li>The functions setRootOnlyMsg, rootOnlyMsg, setUseRootOnlyMsg and
2436 useRootOnlyMsg have been renamed to
2437 setRootOnlyMessage, rootOnlyMessage, setUseRootOnlyMessage and
2438 useRootOnlyMessage.</li>
2439 <li>KCModules need to have Type=Service and ServiceTypes=KCModule in the
2440 .desktop file now - was Type=Application before</li>
2441 <li>KCModules that should show up in KControl or kcmshell --list need to have
2442 X-KDE-ParentApp=kcontrol or kinfocenter</li>
2443 <li>If the KCModule should be used by kcminit you have to add KCModuleInit to
2444 ServiceTypes (i.e. ServiceTypes=KCModule,KCModuleInit then)</li>
2445 <li>The kcm_ prefix in X-KDE-Library is now optional (in KDE3 the
2446 X-KDE-Library value was automatically prefixed with kcm_)</li>
2447 <li>If the kcminit code is in a different lib than the other KCM code the
2448 X-KDE-Init-Library was used. The library name has to be prefixed with kcminit_
2449 now, but the prefix is optional in the .desktop file.</li>
2450 <li>The kcminit symbol now has to be prefixed with kcminit_ (in the code). The
2451 rest of the symbol name is specified with X-KDE-Init-Symbol (was X-KDE-Init
2452 before).</li>
2453 <li>It is now possible to use multiple K_EXPORT_GENERIC_FACTORY calls in one
2454 library. The first parameter to the macro has to be the same as
2455 X-KDE-FactoryName then.</li>
2456 <li>KCModule does no longer take a name argument, but directly a KInstance (having the correct
2457 name for the translations to work.</li>
2459 <li>KCModules will not be embedded running with root privileges anymore.
2460 Instead the GUI code will run with user privileges as every other KCM. Only in
2461 order to write or call programs should the KCM elevate its privileges.</li>
2462 </ul>
2470 <!-- ### TODO: should this not be a KDE3SUPPORT <h3> section? -->
2471 <ul>
2475 </ul>
2478 <ul>
2480 </ul>
2485 <ul>
2487 </ul>
2495 KDE4 uses now Bash scripts with Messages.sh file names.
2496 The Perl script trunk/l10n-kde4/scripts/conversion/Makefile2Messages.pl
2497 can be used as an half-automatic conversion. (Please verify the result!)</p>
2501 parameter of the $XGETTEXT if you are using the class KAboutData and if
2502 you are not explicitly setting KAboutData::setTranslator.</p>
2505 <p>Scripty uses
2507 for extracting
2508 messages out of the source code. This is a huge step from the former xgettext 0.10.35-kde
2509 used in KDE3.</p>
2511 <ul>
2512 <li>If you define your own keywords (-k parameter of xgettext), you probably
2513 need to adapt them, as xgettext does not automatically know about the
2515 <li>You cannot have two similar messages, one being a normal message and
2516 the other being the singular form of a plural-form message. For Gettext, this is
2517 the same message and therefore this creates problems. (Note: there is not
2518 any similar problem with contexts.)</li>
2519 </ul>
2523 <p>Translator comments are a feature that already existed in KDE3, but which
2524 was seldom used.</p>
2525 <ul>
2526 <li>Translator comment are code comments before a i18n call. To avoid
2527 extracting comments that are of little interest for translators, translator
2528 comemnts must start with // i18n: or /* i18n: to mark such comments.
2529 (Note: translator comments starting with TRANSLATORS (all upper case), as it is Gettext's habit are not supported by KDE4.)</li>
2531 using a translator comment instead of a context to give long hints to translators.</li>
2532 </ul>
2533 <pre>
2534 // i18n: this is a test sentence
2535 i18n("The quick brown fox jumps over the lazy dog");
2536 </pre>
2541 <pre>
2542 i18n("Just plain info");
2543 </pre>
2545 <p>If there are arguments, <code>arg</code> methods are no longer used to substitute the placeholders. Instead, arguments are added to the call:</p>
2546 <pre>
2547 i18n("%1 has scored %2", playerName, score);
2548 </pre>
2549 <p>Arguments can be of several integer types, <code>double</code>, <code>QString</code>, <code>QChar</code> (and perhaps more in the future).</p>
2551 <p>Context call now has a different name, <code>i18nc</code>, and takes arguments in the same way:</p>
2552 <pre>
2554 </pre>
2556 <p>Plural call is renamed to <code>i18np</code> and does away with <code>%n</code> placeholder, all being numbered instead:</p>
2557 <pre>
2559 </pre>
2563 <pre>
2565 </pre>
2567 <p><code>i18n*</code> calls are realized as templates, and so will take at most some finite number of arguments.</p>
2570 <ul>
2571 <li>Placeholders are substituted in one pass, so no need to worry about argument itself containing a placeholder.</li>
2572 <li>All same-numbered placeholders are substituted with same argument. This is in contrast to what single-argument <code>arg</code> methods of <code>QString</code> do.</li>
2573 <li>Placeholders directly index arguments: they should be numbered from 1 upwards, without gaps in the sequence so that each argument is indexed. The exception is plural-deciding argument in plural call, where it is allowed to drop its placeholder in either singular or plural form.</li>
2574 </ul>
2576 <p>Sometimes you might need old-style syntax for argument substitution. For example, when there are many arguments, or, more importantly, when it is convenient to <i>defer</i> substitution of arguments. This is possible using new <code>ki18n</code> call, with <code>subs</code> methods for argument substitution and <code>toString</code> method for finalization:</p>
2577 <pre>
2578 KLocalizedString ks = ki18n("The Foo-machine reported: %1");
2579 case (fooErrCode) {
2580 ERR_OXI: ks.subs(i18n("Out of oxidizer")); break;
2581 ERR_HYD: ks.subs(i18n("Out of hydrazine")); break;
2582 ERR_PIL: ks.subs(i18n("Out of pilots")); break;
2583 default: ks.subs(i18n("Unknown catastrophe"));
2584 }
2585 QString scream = ks.toString();
2586 </pre>
2588 <p>Note that <code>ki18n</code> returns object of type <code>KLocalizedString</code>, hence the <code>toString</code> method for conversion to plain <code>QString</code>. The <code>ki18n</code> call should be used rarely; the previous example can as well be rewritten to:</p>
2589 <pre>
2590 QString problem;
2591 case (fooErrCode) {
2592 ERR_OXI: problem = i18n("Out of oxidizer"); break;
2593 ...
2594 }
2595 QString scream = i18n("The Foo-machine reported: %1", problem);
2596 </pre>
2598 <p>Another case when you might want to use <code>ki18n</code> is if you want to format arguments. <code>subs</code> methods can take formatting arguments, similar to those of <code>arg</code> methods in <code>QString</code>. You should <i>never</i> use methods other than <code>subs</code> to format numbers in localized messages:</p>
2599 <pre>
2602 </pre>
2605 <pre>
2609 </pre>
2611 <p>If you need translation using locale (KLocale object) other than the default, you can use overloaded <code>toString</code> method which takes pointer to locale object (this replaces <code>KLocale::translate(...)</code> from KDE3):</p>
2612 <pre>
2613 KLocale *myLocale;
2614 ...
2615 ki18n("Welcome").toString(myLocale);
2616 </pre>
2618 <p>There is a script for semi-automatic conversion of KDE 3 code, <code>i18nk34conv.pl</code> in <code>trunk/l10n-kde4/scripts/conversion/</code>. It will convert most of the calls automatically, and mark the places that need manual review. There is also the script <code>i18ncheckarg.pl</code> in <code>trunk/l10n-kde4/scripts/conversion/</code>, which will check whether placeholders and arguments match. Use it to catch and correct deferred substitutions (like in the examples above). Both these scripts you can just run without any arguments in top directory of your sources (but you can also specify paths or filenames as arguments). <i>Do not</i> run conversion script twice on same sources!</p>
2625 <ul>
2627 </ul>
2630 <ul>
2633 </ul>
2644 <ul>
2645 <li>(alias) means that the old KDE mime type is an alias in the corresponding XDG mime type, so the conversion is not strictly needed (although suggested)</li>
2646 </ul>
2649 <tr>
2652 </tr>
2653 <tr>
2656 </tr>
2657 <tr>
2660 </tr>
2661 <tr>
2664 </tr>
2665 <tr>
2668 </tr>
2669 <tr>
2672 </tr>
2673 <tr>
2676 </tr>
2677 <tr>
2680 </tr>
2681 <tr>
2684 </tr>
2685 <tr>
2688 </tr>
2689 <tr>
2692 </tr>
2693 <tr>
2696 </tr>
2697 <tr>
2700 </tr>
2701 <tr>
2704 </tr>
2705 <tr>
2708 </tr>
2709 <tr>
2712 </tr>
2713 <tr>
2716 </tr>
2717 <tr>
2720 </tr>
2721 <tr>
2724 </tr>
2725 <tr>
2728 </tr>
2729 <tr>
2732 </tr>
2733 <tr>
2736 </tr>
2737 <tr>
2740 </tr>
2741 <tr>
2744 </tr>
2745 <tr>
2748 </tr>
2749 <tr>
2752 </tr>
2753 <tr>
2756 text/x-gettext-translation-template (*.pot)</td>
2757 </tr>
2758 <tr>
2761 </tr>
2762 <tr>
2765 </tr>
2766 <tr>
2769 </tr>
2770 <tr>
2773 </tr>
2774 <tr>
2777 </tr>
2778 <tr>
2781 </tr>
2782 <tr>
2785 </tr>
2786 <tr>
2789 </tr>
2790 <tr>
2793 </tr>
2794 <tr>
2797 </tr>
2798 <tr>
2801 </tr>
2802 <tr>
2805 </tr>
2806 <tr>
2809 </tr>
2810 <tr>
2813 </tr>
2814 <tr>
2817 </tr>
2818 <tr>
2821 </tr>
2822 <tr>
2825 </tr>
2826 <tr>
2829 </tr>
2830 <tr>
2833 </tr>
2834 <tr>
2837 </tr>
2838 <tr>
2841 </tr>
2842 <tr>
2845 </tr>
2846 <tr>
2849 </tr>
2850 <tr>
2853 </tr>
2854 <tr>
2857 </tr>
2858 <tr>
2861 </tr>
2862 <tr>
2865 </tr>
2866 <tr>
2869 </tr>
2870 <tr>
2873 </tr>
2874 <tr>
2877 </tr>
2878 <tr>
2881 image/svg+xml-compressed (*.svgz)</td>
2882 </tr>
2883 <tr>
2886 </tr>
2887 <tr>
2890 </tr>
2891 <tr>
2894 </tr>
2895 <tr>
2898 Specific mime types (all subclasses of image/x-dcraw):<br>
2899 image/x-panasonic-raw (*.raw)<br>
2900 image/x-kodak-dcr (*.dcr)<br>
2901 image/x-adobe-dng (*.dng)<br>
2902 image/x-canon-crw (*.crw *.cr2)<br>
2903 image/x-nikon-nef (*.nef)<br>
2904 image/x-minolta-mrw (*.mrw)<br>
2905 image/x-kodak-k25 (*.k25)<br>
2906 image/x-kodak-kdc (*.kdc)<br>
2907 image/x-olympus-orf (*.orf)<br>
2908 image/x-pentax-pef (*.pef)<br>
2909 image/x-fuji-raf (*.raf)<br>
2910 image/x-sony-sr2 (*.sr2)<br>
2911 image/x-sony-srf (*.srf)<br>
2912 image/x-sigma-x3f (*.x3f)<br>
2913 other extensions that were part of image/x-raw: image/x-kde-raw
2914 </td>
2915 </tr>
2916 <tr>
2919 </tr>
2920 <tr>
2923 </tr>
2924 <tr>
2927 </tr>
2928 <tr>
2931 </tr>
2932 <tr>
2935 </tr>
2936 <tr>
2939 </tr>
2940 <tr>
2943 </tr>
2944 <tr>
2947 </tr>
2948 <tr>
2951 </tr>
2952 <tr>
2955 </tr>
2956 <tr>
2959 </tr>
2960 <tr>
2963 </tr>
2964 <tr>
2967 </tr>
2968 <tr>
2971 </tr>
2972 <tr>
2975 </tr>
2976 <tr>
2979 </tr>
2980 <tr>
2983 </tr>
2984 <tr>
2987 </tr>
2988 <tr>
2991 </tr>
2992 <tr>
2995 </tr>
2996 </table>
3003 KNewStuff is replaced with KNewStuff2. The API for applications has changed
3004 completely, as the library is a rewrite and not an update.
3005 Do not inherit from any class, use only KNS::Engine.
3006 All application-specific properties especially about what to do with
3007 downloaded files are configured in *.knsrc files; have a look at
3008 knewstuff/doc/porting.txt and knewstuff/doc/tutorial.txt.
3011 <ul>
3014 </ul>
3017 <ul>
3020 </ul>
3027 DCOP has been replaced with D-Bus.<br />
3028 Help with porting from DCOP to D-Bus can be found at
3029 <a href="http://techbase.kde.org/Development/Tutorials/Porting_to_D-Bus">http://techbase.kde.org/Development/Tutorials/Porting_to_D-Bus</a>
3037 is still lacking in a print preview feature and a customisable print dialog.
3038 KPrintPreview (kutils) provides the former, and KdePrint::createPrintDialog()
3042 <ul>
3044 <li>using KdePrint::createPrintDialog() (in kdeui) to get a (customised) QPrintDialog, rather than using KPrinter::setup()</li>
3045 <li>using KPrintPreview (in kutils) for print preview, rather than KPrinter::setPreviewOnly(true)</li>
3047 </ul>
3049 <p>If the code uses addDialogPage, you need to change the KPrintDialogPage to a
3050 QWidget, and you can get rid of the getOptions and setOptions methods in favor
3051 of a method for each option (since QPrintDialog doesn't do anything with the widget
3052 except display it). Then the code that called KPrinter::addDialogPage and
3053 KPrinter::setup needs to use KdePrint::createPrintDialog instead and get the options
3054 directly from the widgets passed to createPrintDialog rather than from the QPrinter.
3055 The widgets should also use setWindowTitle() rather than setTitle().</p>
3058 <ul>
3060 <li><a href="http://api.kde.org/4.0-api/kdelibs-apidocs/kutils/html/classKPrintPreview.html">KPrintPreview apidocs</a></li>
3061 <li><a href="http://api.kde.org/4.0-api/kdelibs-apidocs/kdeui/html/namespaceKdePrint.html">KdePrint::createPrintDialog apidocs</a></li>
3062 <li><a href="http://techbase.kde.org/Projects/KDEPrint/KDE4#Porting">KDEPrint Porting on TechBase</a></li>
3063 </ul>
3068 </body>
3069 </html>